Detalles técnicos

Voice API de Vonage permite a los desarrolladores administrar llamadas de voz mediante programación utilizando dos modelos complementarios:

  • Una es iniciado por su aplicaciónmediante llamadas a la API REST o SDK.
  • El otro es solicitados desde tu aplicación por Vonageutilizando webhooks y OCN (Objeto de control de llamadas Nexmo - Nexmo es ahora Vonage) instrucciones.

Este doble enfoque admite una gestión flexible de las llamadas para implementar diversos flujos de llamadas y casos de uso de voz programables, desde simples notificaciones hasta sofisticados flujos de centros de contacto e integración de IA.

Además, la Voice API de Vonage permite:

  • Cree aplicaciones escalables con las tecnologías web que ya utiliza.
  • Controle el flujo de llamadas entrantes y salientes en JSON con NCCO.
  • Grabe y almacene las llamadas entrantes o salientes.
  • Crear conferencias telefónicas.
  • Envía mensajes de texto a voz en 40 idiomas con distintos géneros y acentos.

Contenido

En este documento puedes aprender sobre:

Primeros pasos

Para conocer todos los pasos necesarios para comenzar a utilizar la Voice API de Vonage, consulta la sección Primeros pasos guía.

Iniciar una llamada de voz

Para iniciar una llamada de voz desde su aplicación backend, utilice el punto final HTTP:

POST /calls

Este método inicia una llamada saliente a un número de teléfono o punto final SIP. Puede utilizarlo directamente a través de HTTP o a través de cualquier SDK del servidor de Vonage.

Véase el Hacer una llamada para obtener más información sobre cómo iniciar llamadas salientes.

Cuando la llamada se conecta, Vonage solicita instrucciones (en forma de NCCO) de tu webhook o URL estática para determinar cómo debe proceder la llamada.

Instrucciones de llamada con las OCN

En OCN (objeto de control de llamadas de Nexmo) es una estructura basada en JSON que define lo que debe suceder durante una llamada. Se devuelve en respuesta a la solicitud de webhook de Vonage cuando se conecta la llamada.

Entre las acciones habituales de las OCNN se incluyen:

  • talk - Convierte texto a voz y reprodúcelo a la persona que llama
  • stream - Reproducir un archivo de audio
  • record - Grabar el audio de la llamada
  • connect - Conectar a otro participante a la conversación

Encontrará la lista completa de comandos NCCO en la sección Referencia OCNC.

Control de una llamada activa

Una vez que una llamada está en curso, también puede controlarla dinámicamente mediante los puntos finales de la API REST:

  • PUT /calls/{uuid} - Actualizar el estado de la llamada (por ejemplo, colgar, transferir, silenciar)
  • PUT /talk y DELETE /talk - Iniciar o detener la conversión de texto a voz durante la llamada
  • PUT /talk y DELETE /stream - Iniciar o detener la transmisión de archivos de audio

Estas acciones le permiten modificar el comportamiento de la llamada en tiempo real, basándose en las acciones del usuario y en la lógica de su aplicación.

Véase el Referencia de la Voice API para obtener una lista completa de los puntos finales de la API REST.

Lecturas complementarias