Hacer una llamada de voz
Pruebe la Voice API
En Registrarse para obtener una cuenta API de VonageAcceda a Panel de control para desarrolladores e ir a la Hacer una llamada de voz sección. Aquí puedes hacer una llamada de prueba para ver la Voice API en acción.
Veamos ahora cómo utilizar la Voice API en tu aplicación.
Crear una aplicación
Ir a la Aplicacionesen el cuadro de mandos, y defina una página Name para su solicitud.
Asegúrese de hacer clic en el botón Generar clave pública y privada y guarde el archivo private.key alrededor.
A continuación, active el Voz capacidad. De momento, déjalo todo por defecto.
Por último, haga clic en Generar nueva aplicación en la parte inferior de la página.
Echa un vistazo Primeros pasos con la CLI de Vonage para obtener más información sobre cómo instalar y configurar la CLI.
Utiliza el siguiente comando para crear una aplicación de Vonage:
Una vez que tenga la aplicación, tendrá que añadir el archivo voice asegúrese de sustituir las URL de los webhooks por las suyas propias:
A continuación, la aplicación se crea y dispone de las capacidades necesarias. La creación de una aplicación y la adición de capacidades de aplicación se tratan en detalle en la sección Documentación de las aplicaciones.
Alquilar un Numbers
Para alquilar un número, primero debe añada crédito a su Account.
Puede omitir este paso si desea utilizar el número de prueba 123456789 como identificador de llamadasy llame al número que facilitó al registrarse.
En el cuadro de mandos, vaya a Comprar Numbers página. Asegúrese de marcar Voz en el filtro de búsqueda, y seleccione el país en el que desea comprar un número. En algunos países, es posible que tenga que solicitar un número, ya que pueden ser necesarios documentos adicionales.
A continuación, puede hacer clic en el botón Comprar junto al número que desee y valide su compra.
¡Enhorabuena! Su número virtual ya aparece en Tus Numbers.
Puedes alquilar un número usando la CLI de Vonage. El siguiente comando busca un número disponible en los Estados Unidos:
Utilice este comando para comprar un número:
Especifique un código de país alternativo de dos caracteres comprar un número en otro país.
Realizar una llamada saliente
La principal forma de interactuar con la plataforma de voz de la API de Vonage es a través de la función API pública. Para realizar una llamada saliente, se hace una POST solicitar a https://api.nexmo.com/v1/calls.
Para realizar tu primera llamada con la Voice API, elige tu idioma a continuación y sustituye las siguientes variables en el código de ejemplo:
| Clave | Descripción |
|---|---|
VONAGE_NUMBER | Tu número de Vonage desde el que se realizará la llamada. Por ejemplo 447700900000. Si se ha saltado el Alquilar un Numbers paso, utilice el número de prueba "123456789". |
TO_NUMBER | El número al que desea llamar en formato E.164. Por ejemplo 447700900001. Si se ha saltado el Alquilar un Numbers utilice el número que facilitó al registrarse. |
Requisitos previos
Ejecute el siguiente comando en el símbolo del sistema de su terminal para crear la dirección JWT para la autenticación:
Ejecute su código
Guarde este archivo en su máquina y ejecútelo:
Requisitos previos
Crea un archivo llamado make-an-outbound-call.js y añade el siguiente código:
Ejecute su código
Guarde este archivo en su máquina y ejecútelo:
Requisitos previos
Añada lo siguiente a build.gradle:
Crea un archivo llamado OutboundTextToSpeechCall y añade el siguiente código al método main:
Escriba el código
Añada lo siguiente al método main del archivo OutboundTextToSpeechCall:
Ejecute su código
Podemos utilizar el plugin aplicación para Gradle para simplificar la ejecución de nuestra aplicación. Actualiza tu build.gradle con lo siguiente:
Ejecute el siguiente comando gradle para ejecutar su aplicación, sustituyendo com.vonage.quickstart.kt.voice por el paquete que contiene OutboundTextToSpeechCall:
Requisitos previos
Añada lo siguiente a build.gradle:
Crea un archivo llamado OutboundTextToSpeech y añade el siguiente código al método main:
Escriba el código
Añada lo siguiente al método main del archivo OutboundTextToSpeech:
Ejecute su código
Podemos utilizar el plugin aplicación para Gradle para simplificar la ejecución de nuestra aplicación. Actualiza tu build.gradle con lo siguiente:
Ejecute el siguiente comando gradle para ejecutar su aplicación, sustituyendo com.vonage.quickstart.voice por el paquete que contiene OutboundTextToSpeech:
Requisitos previos
Requisitos previos
Ejecute su código
Guarde este archivo en su máquina y ejecútelo:
Requisitos previos
Escriba el código
Añada lo siguiente a make-an-outbound-call.py:
from vonage import Auth, Vonage
from vonage_voice import CreateCallRequest, Phone, ToPhone
client = Vonage(
Auth(
application_id=VONAGE_APPLICATION_ID,
private_key=VONAGE_PRIVATE_KEY,
)
)
response = client.voice.create_call(
CreateCallRequest(
answer_url=[VOICE_ANSWER_URL],
to=[ToPhone(number=VOICE_TO_NUMBER)],
from_=Phone(number=VONAGE_VIRTUAL_NUMBER),
)
)
pprint(response)Ejecute su código
Guarde este archivo en su máquina y ejecútelo:
Requisitos previos
Ejecute su código
Guarde este archivo en su máquina y ejecútelo:
Para facilitar esta tarea, Vonage ofrece SDK de servidor en varios idiomas que se encargan de la autenticación y de crear el cuerpo de solicitud correcto para usted.
¿Y ahora qué?
Una vez que hayas hecho tu primera llamada, estarás listo para probar otros aspectos de la Voice API. Le recomendamos que empiece por Detalles técnicos para obtener una descripción general de Voice API de Vonage. Para comprender varios flujos de llamadas, consulta la página Flujo de llamadas guía. Si está interesado en crear una aplicación básica de notificación por voz, consulte la guía Notificaciones de voz Guía práctica. Para más información, consulte nuestra documentación sobre Voice API.