メニュー

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Twilio Channels

公開ベータ

Twilio Channels are currently available as a Public Beta product. Some features are not yet implemented and others may be changed before the product is declared as Generally Available.

公開ベータ製品は、Twilioでのサポート対象外となります。

Channels are the collection of third-party integrations that let you send and receive messages on multiple channels with the Twilio APIs you already use. Using Channels with Twilio makes it easy to reach your customers on new platforms, such as Facebook Messenger, LINE, WhatsApp, and more.

Channels are available through the Twilio Marketplace; you can choose from a list of verified Channels and install them in a single click. Once installed, they allow you to send and receive messages with other communications platforms using the Twilio API.

サポート対象製品

Twilio Channels は現在、Programmable SMS と Notify に対応しています。ここをクリックして、各Channelをインストールするか、各Channelのデベロッパープレビューを要求してください。

Channels in Public Beta:
Facebook Messenger
LINE
WhatsApp

デベロッパープレビュー中のChannel:
RCS

サービス利用規約

Channels are provided and supported by Channel providers in the Twilio Marketplace. As a part of the Channel installation process, you will be required to accept the Channel provider’s Terms of Service. Note that the Channel is provided under the Partner’s Terms of Service & Privacy policy. Channel-specific documentation can be found inside the Console under the Channel's catalog page.

Channelのセットアップと設定

Channelのインストール

Channelを始めるのは簡単です。利用可能なChannelは、管理画面のChannelカタログにリストされています。利用を始めるには、Channelをクリックしてインストールします。すると、1つのChannelインスタンスが作られ、固有の識別子を使って設定し、Twilio製品と連携できるようになります。

WhatsApp Beta

To get started with the Twilio API for WhatsApp, see the API docs here.

Channelプロバイダの認証と設定

In order to send and receive messages from a Channel, you must have an account set up within the specified platform. You will then authorize Twilio to send and receive messages on your behalf, thereby enabling access to each platform through the Twilio API.

Once a Channel is enabled, the next step is to authenticate the Channel instance with the Channel provider. This also links the Channel instance to a Channel-specific endpoint (such as a Facebook page) within that Channel. The specifics of this vary from Channel to Channel; please refer to Channel-specific documentation on the Channel detail page inside the console.

Channelが認証されたら、Twilio APIから動かせるよう設定します。

設定パラメータ 概要
Channel address This is a unique identifier for the user facing Channel endpoint such as a Facebook Page. Channel addresses take the form of channel-provider:identifier. For instance, the Channel address for a Facebook Channel is messenger:<page id>. This can not be changed by the end user.
Callback URL メッセージが届くたびにTwilioがPOSTを投げる先のURL。Twilioが送ってくるリクエストの形式はSMS受信のTwiMLリクエストと同じです。絶対パスURLで指定する場合は、有効なホスト名が含まれていなければなりません(アンダーバーは利用不可)
Callback Method Callback URL を送るメソッドの指定。GET or POST.
Fallback URL Callback URLの先からエラーが返った場合に、TwilioがPOSTを送る先のURL。
Fallback Method Fallback URL を送るメソッドの指定。GET or POST.
Status Callback URL 送信したメッセージのステータスが failed または sent に変化したときにTwilioがPOSTを投げる先のURL。Twilio は、標準TwiMLリクエストパラメータと同様に、標準ステータスパラメータMessageStatusErrorCode もPOSTします。絶対パスURLで指定する場合は、有効なホスト名が含まれていなければなりません。(アンダーバーは利用不可)
StatusCallbackMethod Status Callback を送るメソッドの指定。GET or POST.

Channel で複数のインスタンスを作る

Twilio supports creating multiple instances of a Channel so that your application can use different Channel-specific endpoints. For example, this allows you to support sending/receiving messages from multiple Facebook pages, by creating and associating each Facebook page with an instance of the Facebook Channel.

Channel を利用する

Channel経由でメッセージを送受信するには、Twilio API製品群を利用できます。必要なのは、Channel をインストールしたときに設定した Channel address を参照することです。

Channel を設定したら、どのTwilio製品でChannelを使うか、各プロダクトの「Use In」チェックボックスを選択します。

Channel Addresses

Each Channel uses a different unique identifier scheme to address users. The table below lists how users are identified by each supported Channel when used with Twilio APIs. For more details on endpoints and addresses for a given Channel, please refer to Channel-specific documentation on the Documentation page linked to from the Channel detail page inside the console.

Channel エンドユーザーに見えるChannel endpoint Channel endpoint address Channel user address 注釈
Facebook Messenger Facebook Page messenger:{page-id} messenger:{messenger id} または messenger:{e164 formatted phone number} Messanger ID と Facebook ID は別物です。FacebookページとMessangerユーザーの間で固有になる識別子です。この値は、Facebookメッセンジャーユーザーがメッセージを送信して初めて取得できます。
電話番号経由でメッセンジャーユーザーをアドレスするには、Facebook側でこの機能を有効化してある必要があります。
RCS Business Identity rcs:{channel-install-sid} rcs:{e164 formatted phone number}
LINE Business Identity line:{line-channel-id} line:{line-channel-id} line-channel-id は userName とは別物です。外部サービス側でユーザーを一意に識別するのに必要です。

WhatsApp Beta

See the table below for the addressing scheme for WhatsApp:

Channel エンドユーザーに見えるChannel endpoint Channel endpoint address Channel user address 注釈
WhatsApp Business phone number whatsapp:{e164 formatted phone number} whatsapp:{user's e164 formatted phone number} See here to get started with WhatsApp.

Programmable SMS

Programmable SMS で Channel を使うには「Use In: Programmable SMS Inbound」のチェックボックスをONにします。

メッセージの送信

Programmable SMS APIを使ったChannelによるメッセージの送信についての詳細は、ドキュメント REST API: SMS/MMSの送信または REST API: メッセージを参照してください。

以下は、Programmable SMS を使ってFacebookメッセンジャーへメッセージを送信する例です:

curl -X "POST" \
--data-urlencode 'To=messenger:{Messenger User ID}' \
--data-urlencode 'From=messenger:{Facebook Page ID}' \
--data-urlencode 'Body=Would you like to play a game?' \
-u {Account Sid}:{Auth Token} \
https://api.twilio.com/2010-04-01/Accounts/{AccountSID}/Messages.json

メッセージの受信

Programmable SMSをサポートするChannel でメッセージを受信するには、Channel をインストールしてから設定セクション内の Callback URL を指定します。このURLで、SMS受信TwiMLのコールバックと同じ形式のコールバックを受け取ります。

Managing Opt-Ins, Opt-Outs, and Consumer Preferences

SMSアプリケーションでユーザーのオプトインが課されるように、OTTプラットフォームでは自身のユーザーのオプトイン管理が必須となります。ご自身のアプリケーションのユーザーが、各Channel からメッセージによるコンタクトを行うことを明確に承諾できるような仕組みを用意しなければなりません。例えば、「テキストメッセージを送る行為」についてオプトインしていた場合でも、これが同時に「メッセンジャー経由でその人にコンタクトを取る行為」を許可したことにはなりません。

Similarly, you should respect consumers who opt-out on each platform. Each platform has its own method of opting out, which Twilio will normalize for you as much as possible. For example, consumers may text STOP to opt-out of SMS, or they may block your application to stop messaging within an OTT channel. If a user opts out of one communication channel, you are NOT required to opt them out of all channels. You may treat each opt-in and opt-out independently.

Rate this page:

ヘルプが必要ですか?

誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。