音声プロバイダー

Voice プロバイダーは、以下のウェブフックをリッスンすることができます。 Voice API.通話の録音をダウンロードすることもできます。

機能

  • onCall - この関数を使うと、Voice API を使った着信 Webhook に対して NCCO を返すことができます。コード・スニペット これ.
  • onCallEvent- この関数を使用すると、Voice API を使用してコールイベントのウェブフックを処理できます。コード・スニペット これ.
  • getCallRecording - この関数を使用すると、通話が完了した時点で通話録音をダウンロードできます。コードスニペットを見る これ.
  • uploadCallRecording - このヘルパー関数を使うと、Voice API 呼び出しを直接 資産プロバイダー.コードスニペットを見る これ.

注: を使用する。 vcr.verifyAuth 方法 を使用して、コールバックがCloud Runtime Platformから発信されていることを検証します。

音声プロバイダーの初期化

Voice Providerを使用するには、セッションを使用してプロバイダのインスタンスを作成する必要があります:

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

地域

Voice APIへの着信コールは、次のように指定したアプリケーションと同じ地域のデータセンターに送られます。 vcr.yml.例えば、以下のようなアプリケーションです。 aws.use1 によって処理されます。 音声APIデータセンター.イニシャライザにリージョンURLを指定することで、Voiceプロバイダが使用するリージョンを指定できます:

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

便宜上、Voice APIからの受信Webhookには region_url プロパティに渡すことができます:

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

ユースケース

例えば、Voice プロバイダを使用して、かかってきた Voice API Call に応答することができます:

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