はじめに

このチュートリアルでは、コールからのイベントを受け取るためのウェブフックの作成方法を学びます。 webhookを使うことで、ユニークなリアルタイムコールアプリケーションを作成し、ユーザーに喜ばれる製品を作ることができます。

コールが発信または受信されると、webhooks APIを使用してアクティブなコールを監視できます。webhookは以下の情報を返します：

json { "event"：{ "accountId"："{your_account_id}"、 "callerId"："{caller_name}"、 "direction"："{DIRECTION}"、 「duration」：{通話の長さ}、 「外部ID」(externalId)：「ID}」、 id": "{ID}"："{ID}"、 "internal"：{internal_flag}、 "phoneNumber"："{phone_number"、 "startTime"："ios8601時間"、 "state"："{通話状態}"、 "type"："{CALL_TYPE}"、 「ucpType"："", "userId"："{USER_ID": "{USER_ID } }

コールのステータスが変更されると、新しいペイロードがWebhookに送信されます：

* 通話が始まると、`state` が `RINGING` のペイロードが送られる。
通話が始まると、`state`が`RINGING`のペイロードが送られる。 * 通話に応答すると、`state`が`ACTIVE`のペイロードが送られる。
* 通話が終了すると、`ANSWERED`という`state`のペイロードを受け取る。
* 通話が終わると、`ANSWERED`という状態のペイロードが送られる。

webhook のペイロードの詳細については、[webhooks documentation](/vonage-business-cloud/vonage-integration-platform/concepts/webhooks) を参照してください。