Sprachdienstleister

Der Voice-Provider ermöglicht es Ihnen, auf Webhooks von der Voice API. Sie können auch Gesprächsaufzeichnungen herunterladen.

Funktionen

  • onCall - Mit dieser Funktion können Sie einen NCCO für Webhooks für eingehende Anrufe über die Voice API zurückgeben. Siehe das Codeschnipsel hier.
  • onCallEvent- Mit dieser Funktion können Sie Anrufereignis-Webhooks über die Voice API verarbeiten. Siehe das Codeschnipsel hier.
  • getCallRecording - Mit dieser Funktion können Sie eine Anrufaufzeichnung herunterladen, sobald ein Anruf beendet ist. Siehe das Codeschnipsel hier.
  • uploadCallRecording - diese Hilfsfunktion ermöglicht es Ihnen, Voice API-Aufrufe direkt mit dem Anbieter von Vermögenswerten. Siehe das Codeschnipsel hier.

Anmerkung: Verwenden Sie die vcr.verifyAuth Methode um zu verifizieren, dass die Rückrufe von der Cloud Runtime Platform stammen.

Initialisierung des Sprachproviders

Um den Voice Provider zu verwenden, müssen Sie eine Instanz des Providers mithilfe einer Sitzung erstellen:

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

Regionen

Eingehende Anrufe an die Voice API werden an die Rechenzentren in der Region weitergeleitet, in der auch die in Ihrem Profil angegebene Anwendung liegt. vcr.yml. Zum Beispiel, Applikationen mit aws.use1 in der Konfigurationsdatei wird von der US Voice API-Rechenzentrum. Sie können angeben, welche Region der Sprachanbieter verwenden soll, indem Sie dem Initialisierer eine URL für die Region übergeben:

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

Der Einfachheit halber werden eingehende Webhooks von der Voice API mit einem region_url Eigenschaft, die Sie direkt an den Voice-Provider-Initialisierer übergeben können:

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

Anwendungsfall

So können Sie beispielsweise den Voice API-Anbieter verwenden, um einen eingehenden Voice API-Anruf zu beantworten:

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