Fournisseur de services vocaux

Le fournisseur de services vocaux vous permet d'écouter les webhooks provenant de l'application Voice API. Vous pouvez également télécharger des enregistrements d'appels.

Fonctions

• onCall - cette fonction vous permet de renvoyer un NCCO pour les webhooks d'appels entrants utilisant l'API Voice. Voir l'extrait de code ici.
• onCallEvent- cette fonction vous permet de gérer les webhooks d'événements d'appel à l'aide de l'API Voice. Voir l'extrait de code ici.
• getCallRecording - cette fonction vous permet de télécharger l'enregistrement d'un appel une fois celui-ci terminé. Voir l'extrait de code ici.
• uploadCallRecording - cette fonction d'aide vous permet de stocker directement les appels à l'API Voice avec la fonction Fournisseur d'actifs. Voir l'extrait de code ici.

Initialisation du fournisseur de services vocaux

Pour utiliser le fournisseur de services vocaux, vous devez créer une instance du fournisseur à l'aide d'une session :

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

Régions

Les appels entrants vers l'API Voice seront dirigés vers les centres de données situés dans la même région que l'application spécifiée dans votre vcr.yml. Par exemple, les applications avec aws.use1 dans le fichier de configuration sera traitée par le système de gestion des données de l'US Centre de données Voice API. Vous pouvez spécifier la région que vous souhaitez que le fournisseur de services vocaux utilise en fournissant une URL de région à l'initialisateur :

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

Pour votre commodité, les webhooks entrants de la Voice API auront un nom de fichier region_url que vous pouvez passer directement à l'initialisateur du fournisseur de voix :

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

Cas d'utilisation

Par exemple, vous pouvez utiliser le fournisseur Voice pour répondre à un appel Voice API entrant :

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!'
        }
    ]);
});
``