Skip to main content
La voz es el teléfono en tu sistema: llamas con un número del workspace, hablas texto (TTS), reproduces audio, recoges dígitos (DTMF) y cuelgas o transfieres, sin montar operadora y troncal SIP desde cero.

​
¿Qué es Voz en Notifique?

Es el canal para originar y controlar llamadas usando números contratados en el workspace. Sirve para confirmación de pedido, IVR simple (presione 1, 2…), marcador y atención inbound con eventos en tu URL. Puedes:
  • Originar llamadas salientes con TTS, audio o recogida DTMF
  • Controlar la sesión en tiempo real (speak, gather, transfer, hangup, etc.)
  • Grabar tramos de la llamada y descargar el archivo después
  • Recibir llamadas inbound con reenvío, TTS o control vía webhook
  • Seguir cada etapa por API o webhooks
Piensa en una central telefónica ligera: marca, habla, escucha teclas y avisa a tu backend en cada paso.
A diferencia de WhatsApp, la voz no usa instancia de canal. Necesitas un número contratado y activo en el workspace, saldo o créditos (cobro por minuto) y API Key con permiso para marcar.

​
¿Cuándo usar?

Sin número activo contratado, el canal no marca.

​
Cómo funciona en la práctica

  1. Contrata un número y déjalo activo — la llamada sale de esa línea (Números de teléfono)
  2. Elige quién llama y quién recibe (from y to en la API)
  3. Al contestar, define qué pasa: texto hablado (TTS), audio grabado o menú de teclas
  4. La plataforma marca, conecta y actualiza el estado; los webhooks avisan cada etapa
  5. Controla la llamada en curso por la API (hablar más, transferir, colgar)
  6. Cuando alguien te llama, configura reenvío, mensaje automático o control vía webhook en el número
Cada API Key pertenece a un workspace. En v1 no envíes x-workspace-id. Usa clientState para correlacionar con tu CRM o cola.

​
Ciclo de la llamada

Después de originar, la llamada pasa por QUEUED, INITIATED, RINGING, ANSWERED, COMPLETED o FAILED. Webhooks como voice.call.answered y voice.call.completed mantienen tu backend sincronizado sin polling.

​
Qué puedes hacer

  • Originar a 1 a 500 destinos por llamada (to en array)
  • Listar y consultar historial (voice:read)
  • Ejecutar acciones en llamada activa (voice:control)
  • Descargar grabación cuando llegue voice.call.recording.ready
  • Programar marcado futuro (panel y misma regla de plan que SMS/Push)
  • Traducir el guion hablado (speakText y prompt de gather) por idioma del contacto
  • Webhook dedicado por llamada (options.webhook) además de los webhooks globales del workspace
  • Detectar buzón de voz con amdMode (disabled, detect, premium)
  • Consultar precio por país de destino vía Consulta de precios o panel
  • Reaccionar al ciclo del número (phone_number.activated, phone_number.suspended, etc.)
Detalle de campos y errores: referencia de la API en la pestaña Voz. Cobro: Cobro.

​
Opciones extra (como en los otros canales)

Alineado con SMS, Push y E-mail:
  • Traducir el texto hablado — el sistema habla en portugués, inglés u otro idioma según el contacto en el CRM (Localización e i18n)
  • Programar el marcado — llama después, en fecha y hora futura (plan de pago, igual que SMS)
  • Webhook solo de esta llamada — los eventos de una llamada específica van a una URL extra
  • Metadatos — etiquetas de tu campaña o CRM guardadas junto con la llamada
Guía de webhooks: Eventos de webhooks.
La traducción automática aplica a texto hablado y menú de teclas. El audio grabado por URL y el IVR publicado usan el contenido que enviaste — sin traducción automática en esa ruta.

​
Después de la primera llamada

  • Sigue por webhooks (voice.call.* y phone_number.*)
  • Monta IVR con gather + voice.call.dtmf / voice.call.gather.ended
  • Prueba inbound con WEBHOOK_CONTROL en el número

​
Próximos pasos