Proveedor de voz

El proveedor Voice permite escuchar los webhooks de la aplicación Voice API. También puedes descargar grabaciones de llamadas.

Funciones

• onCall - esta función le permite devolver una NCCO para webhooks de llamadas entrantes utilizando la Voice API. Vea 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 permite descargar la grabación de una llamada una vez finalizada. Vea 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. Vea el fragmento de código aquí.

Inicialización del proveedor de voz

Para utilizar el proveedor de voz es necesario crear una instancia del proveedor utilizando una sesión:

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

Regiones

Las llamadas entrantes a la Voice API llegarán a los centros de datos de la misma región que la aplicación especificada en sus 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 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!'
        }
    ]);
});
``