Skip to main content
La voz es telefonía en su sistema: llame desde un número de espacio de trabajo, diga texto (TTS), reproduzca audio, recopile dígitos (DTMF) y cuelgue o transfiera, sin crear una infraestructura de operador y troncal SIP desde cero.

​
¿Qué es Voice on Notifique?

Es el canal para generar y controlar llamadas telefónicas utilizando números contratados en el espacio de trabajo. Excelente para confirmación de pedido, IVR simple (presione 1, 2…), marcadores y manejo entrante con eventos en su URL. Puede:
  • Origen llamadas salientes con TTS, audio o recopilación DTMF
  • Controlar la sesión activa en tiempo real (speak, gather, transfer, hangup, etc.)
  • Grabar segmentos de llamadas y descargar el archivo más tarde
  • Recibir llamadas entrantes con reenvío, TTS o control de webhook
  • Seguimiento de cada paso mediante API o webhooks
Piense en un sistema telefónico eficiente: marca, habla, escucha las teclas y notifica a su backend en cada paso.
A diferencia de WhatsApp, la voz no utiliza una instancia de canal. Necesita un número de espacio de trabajo ACTIVO, saldo o créditos (facturación por minuto) y una clave API con los alcances correctos.

​
¿Cuándo usarlo?

Funciona muy bien para confirmación de llamadas, menús DTMF IVR y grabación de llamadas para auditoría. Si solo necesita mensajes de texto en el móvil, prefiera SMS o WhatsApp. Sin un número ACTIVO contratado, el canal no puede marcar.

​
Cómo funciona en la práctica

  1. Contratar y activar un número, ver Números de teléfono
  2. Origen con from (su número), to (destino E.164 con +) y el mensaje inicial (speak, playAudioUrl, gather, etc.)
  3. La plataforma marca, conecta y actualiza el estado; webhooks notifican cada paso
  4. Controlar la sesión activa con acciones API, alcance voice:control
  5. Entrante: configurar inboundVoiceAction en el número (FORWARD, TTS_HANGUP, WEBHOOK_CONTROL)
Cada Clave API pertenece a un espacio de trabajo. En v1 no enviar x-workspace-id. Utilice clientState para correlacionarlo con su CRM o cola.

​
Ciclo de vida de la llamada

Después de originarse, la llamada pasa por QUEUED, INITIATED, RINGING, ANSWERED, COMPLETED o FAILED. Los webhooks como voice.call.answered y voice.call.completed mantienen el backend sincronizado sin realizar sondeos.

​
Qué puedes hacer

  • Origen de 1 a 100 destinos por llamada (to como matriz)
  • Historial de listas y consultas (voice:read)
  • Ejecutar acciones en llamadas activas (voice:control)
  • Descargar grabaciones cuando llegue voice.call.recording.ready
  • Detectar correo de voz con machineDetection
  • Reaccionar al ciclo de vida del número (phone_number.activated, phone_number.suspended, etc.)
Detalles de campo y error: Referencia de API en la pestaña Voz. Facturación: Facturación.

​
Después de tu primera llamada

  • Seguimiento vía webhooks (voice.call.* y phone_number.*)
  • Construir IVR con gather + voice.call.dtmf / voice.call.gather.ended
  • Prueba entrante con WEBHOOK_CONTROL en el número

​
Próximos pasos