Detalles técnicos

Introducción

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 de Nexmo —Nexmo ahora es 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:

  • Crea aplicaciones que se adapten a tus necesidades utilizando las tecnologías web que ya utilizas.
  • Controla el flujo de llamadas entrantes y salientes en formato JSON con NCCO.
  • Grabar y almacenar llamadas entrantes o salientes.
  • Crear conferencias telefónicas.
  • Envía mensajes de texto a voz en 40 idiomas con distintos géneros y acentos.

Índice

En este documento podrás obtener información 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 de servidor de Vonage.

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

Cuando se establece la llamada, Vonage solicita instrucciones (en forma de NCCO) a través de tu webhook o URL estática para determinar cómo debe continuar la llamada.

Instrucciones de llamada con las OCN

Un 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 establece la conexión de la llamada.

Entre las acciones habituales de la NCCO 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 reproducción de un archivo de audio

Estas acciones te permiten modificar el comportamiento de las llamadas en tiempo real, en función de las acciones del usuario y de la lógica de tu aplicación.

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

Informes

La Reports API es un método centralizado para recuperar datos de uso y de informes de todos los productos de Vonage, lo que ofrece a los desarrolladores y a las empresas una forma coherente de realizar un seguimiento de la actividad, la facturación y los detalles de las transacciones, incluidos los registros de llamadas y los números de teléfono. Simplifica la elaboración de informes al reunir los datos de uso y facturación de varias API de Vonage en un único formato coherente. La Reports API se puede utilizar en una amplia variedad de casos de uso, entre los que se incluyen:

  • Facturación a clientes: descargue las transacciones relacionadas con todas sus subcuentas y utilice los datos de precios incluidos para determinar lo que debe facturar a sus clientes.
  • Conciliación de facturas: compare sus datos de uso con la factura que ha recibido.
  • Supervisión y análisis: añade datos CDR en tiempo real a tu sistema de inteligencia empresarial o de análisis para correlacionarlos con otros eventos.
  • Gestión de campañas: supervisa el rendimiento de tu campaña mediante herramientas de autoservicio.
  • Depuración: solucione problemas explorando hasta 13 meses de datos de uso detallados.

Véase el Documentación de la Reports API Para obtener más información, como guías, fragmentos de código, prácticas recomendadas y precios.

Lecturas complementarias