Skip to content

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コンソール

リクエスト本文

Twilio APIでは、リクエスト本文がURLエンコードされていることを想定しているため、まずBraze WebhookコンポーザーのリクエストタイプをRaw Textに変更する必要があります。リクエスト本文に必要なパラメーターは、ToFromBodyです。

次のスクリーンショットは、各ユーザーの電話番号に「Hello from Braze!」という本文でSMSを送信する場合のリクエストの例です。

  • ターゲットオーディエンスの各ユーザープロファイルに、有効な電話番号が必要です。
  • Twilioのリクエスト形式に対応するため、メッセージコンテンツにurl_param_escape Liquidフィルターを使用します。このフィルターは文字列をエンコードし、HTMLリクエストですべての文字が許可されるようにします。例えば、電話番号+12125551212のプラス文字(+)はURLエンコードデータでは禁止されており、%2B12125551212に変換されます。

Webhook本文

リクエストヘッダーとメソッド

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_SIDTWILIO_AUTH_TOKENは、必ずTwilioダッシュボードの値に置き換えてください。最後に、TwilioのAPIエンドポイントはHTTP POSTリクエストを想定しているため、HTTP Methodのドロップダウンでそのオプションを選択します。

Webhookメソッド

リクエストのプレビュー

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

Webhookプレビュー

New Stuff!