ステータス・コールバック

概要

Status Callbacks allow you to receive events related to the REST resources managed by Twilio: Rooms, Recordings and Compositions.

すべてのHTTPリクエストの「Content-Type」ヘッダーは“application/x-www-urlencoded”に設定されます。

目次

• Room Status Callbacks
  • Room Status Callback Events
  • Roomsステータスコールバックリクエストパラメーター
  • Recordingsステータスコールバックのリクエストパラメーター
• Compositions Status Callbacks
  • Compositions Status Callback events
  • Compositions Status Callback request parameters

Rooms ステータスコールバック

Rooms Status Callbacks allow you to receive events related to your Rooms via HTTP request. Configure a StatusCallback URL when creating a Room using the REST API, and Twilio will make an HTTP request (webhook) to that URL whenever an event takes place in the Room.

Rooms APIは下記のステータスコールバックイベントを生成します。

Rooms ステータスコールバックイベント

The following events are dispatched to webhook URL specified at Room creation.

例

A curl example of configuring the StatusCallback URL.

 curl -XPOST 'https://video.twilio.com/v1/Rooms' \
 -u '{API Key SID}:{API Secret}' \
 -d 'UniqueName=DailyStandup' \
 -d 'StatusCallback=https://hooks.yoursite.com/room-events' \
 -d 'StatusCallbackMethod=POST' \
 -d 'Type=peer-to-peer'

Roomsステータスコールバックリクエストパラメーター

Twilio passes the following parameters in each of the above-listed events whenever it makes an HTTP request to the StatusCallback URL you've set:

Recordingsステータスコールバックのリクエストパラメーター

The parameters below are included only in events related to Recordings.

Composition Status Callbacks

Compositions Status Callbacks allow you to receive events related to your Compositions via HTTP request. Configure a StatusCallback URL when creating a Composition using the REST API, and Twilio will make an HTTP request (webhook) to that URL whenever an event takes place in the Composition.

The Compositions API will generate the following Status Callback events.

Compositions Status Callback events

The following events are dispatched to webhook URL specified at Composition creation.

Compositions Status Callback request parameters

The parameters below are included in the composition-* events.