Proveedor de servicios de voz

El proveedor de Voice te permite recibir webhooks desde el Voice API. También puedes descargar las grabaciones de las llamadas.

Funciones

• onCall - Esta función te permite devolver un NCCO para los webhooks de llamadas entrantes mediante la Voice API. Consulta el fragmento de código aquí.
• onCallEvent - esta función le permite gestionar webhooks de eventos de llamada utilizando la Voice API. Vea el fragmento de código aquí.
• getCallRecording - Esta función te permite descargar la grabación de una llamada una vez que esta haya finalizado. Consulta el fragmento de código. aquí.
• uploadCallRecording - esta función de ayuda le permite almacenar directamente las llamadas Voice API con la función Proveedor de activos. Mira el fragmento de código aquí.

Inicialización del proveedor de voz

Para utilizar el proveedor de voz, debes crear una instancia del proveedor mediante una sesión:

const session = vcr.createSession();
const voice = new Voice(session);

Regiones

Las llamadas entrantes a la Voice API se redirigirán a los centros de datos de la misma región que la aplicación especificada en tu vcr.yml. Por ejemplo, las aplicaciones con aws.use1 en el archivo de configuración serán gestionados por el sistema US Centro de datos de la Voice API. Puede especificar qué región desea que utilice el proveedor de voz proporcionando una URL de región al inicializador:

const session = vcr.createSession();
const voice = new Voice(session, 'https://api-us-3.vonage.com');

Para su comodidad, los webhooks entrantes de la Voice API tendrán una etiqueta region_url que puede pasar directamente al inicializador del proveedor de voz:

{
    "conversation_uuid": "CON-6f25f6f9-aefc-4c63-bec9-c9f6246d9ff7",
    "from": "4471234567890",
    "region_url": "https://api-us-3.vonage.com",
    "to": "4471234567891",
    "uuid": "9ba07541b67ce06fd2a69432308d2a5a"
}

Caso práctico

Por ejemplo, puede utilizar el proveedor Voice para responder a una llamada entrante de la Voice API:

const session = vcr.createSession();
const voice = new Voice(session);

await voice.onCall('onCall');

app.post('/onCall', async (req, res, next) => {
    res.json([
        {
            action: 'talk',
            text: 'Hello from Vonage!'
        }
    ]);
});
``