Twilio
この例では、Twilioのメッセージ送信APIを介して、SMSとMMSをユーザーに送信するようにBraze Webhookチャネルを設定します。便宜上、ダッシュボードにはTwilio Webhookテンプレートが含まれています。
HTTP URL
WebhookのURLは、ダッシュボードでTwilioから提供されます。このURLにはTwilioアカウントID(TWILIO_ACCOUNT_SID)が含まれているため、Twilioアカウントに固有のURLとなります。
Twilioの例では、Webhook URLはhttps://api.twilio.com/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.jsonです。このURLは、TwilioコンソールのGetting Startedセクションに記載されています。

リクエスト本文
Twilio APIでは、リクエスト本文がURLエンコードされていることを想定しているため、まずBraze WebhookコンポーザーのリクエストタイプをRaw Textに変更する必要があります。リクエスト本文に必要なパラメーターは、To、From、Bodyです。
次のスクリーンショットは、各ユーザーの電話番号に「Hello from Braze!」という本文でSMSを送信する場合のリクエストの例です。
- ターゲットオーディエンスの各ユーザープロファイルに、有効な電話番号が必要です。
- Twilioのリクエスト形式に対応するため、メッセージコンテンツに
url_param_escapeLiquidフィルターを使用します。このフィルターは文字列をエンコードし、HTMLリクエストですべての文字が許可されるようにします。例えば、電話番号+12125551212のプラス文字(+)はURLエンコードデータでは禁止されており、%2B12125551212に変換されます。

リクエストヘッダーとメソッド
Twilioでは、リクエストのContent-TypeとHTTP基本認証ヘッダーの2つのリクエストヘッダーが必要です。Webhookコンポーザーの横にある歯車アイコンをクリックし、Add New Pairを2回クリックして、Webhookに追加します。
| ヘッダー名 | ヘッダー値 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
| Authorization | Basic {{ 'TWILIO_ACCOUNT_SID:TWILIO_AUTH_TOKEN' | base64_encode }} |
TWILIO_ACCOUNT_SIDとTWILIO_AUTH_TOKENは、必ずTwilioダッシュボードの値に置き換えてください。最後に、TwilioのAPIエンドポイントはHTTP POSTリクエストを想定しているため、HTTP Methodのドロップダウンでそのオプションを選択します。

リクエストのプレビュー
Webhookコンポーザーを使って、ランダムなユーザーまたは特定の認証情報を持つユーザーのリクエストをプレビューし、リクエストが正しくレンダリングされていることを確認します。
