Facebook Messenger
Facebook Messengerは、世界で最も人気があるインスタントメッセージングプラットフォームの1つで、1か月あたりのアクティブユーザー数は10億にのぼります。ブランドはこのプラットフォームで、顧客とインテリジェントかつ自動的にやり取りするための魅力的なチャットボットを作成できます。
BrazeとFacebookの統合では、Messenger Platform APIを介してFacebook Messengerのユーザーにメッセージを送信するために、Braze Webhook、セグメンテーション、パーソナライゼーション、トリガー機能が利用されます。カスタムFacebook Messenger Webhookテンプレートは、Brazeプラットフォームの テンプレート > Webhookテンプレート にあります。
Facebook Messengerプラットフォームは、「既存の取引を促進し、他の顧客サポートアクションを提供し、個人が要求したコンテンツを配信する非プロモーションメッセージ」を対象としています。詳細については、Facebookのプラットフォームガイドラインと許容可能なユースケースの例を参照してください。
前提条件
統合を進める前に、以下を確認してください。
- Facebookでは、マーケティングメッセージの送信にMessengerプラットフォームを使用することを許可していません。
- お客様のページからのメッセージに対するユーザーの明示的な許可が必要になります。
- Facebookアプリのテストユーザーではないユーザーにメッセージを送信するには、アプリがFacebookのアプリレビューに合格する必要があります。
| 必要条件 | 提供元 | アクセス | 説明 |
|---|---|---|---|
| Facebook Messengerページ | https://www.facebook.com/pages/create | Facebookページがボットの IDとして使用されます。アプリとチャットすると、ページ名とプロファイル画像が表示されます。 | |
| Facebook Messengerアプリ | https://developers.facebook.com/apps | Facebookアプリには、アクセストークンなどのMessengerボットの設定が含まれています。 | |
| アプリボットの審査と承認 | https://developers.facebook.com/docs/messenger-platform/app-review | ボットを公開する準備ができたら、審査と承認を受けるためにFacebookに提出する必要があります。この審査プロセスにより、MessengerボットがFacebookのポリシーを遵守し、期待どおりに機能することが確認され、Messengerのすべてのユーザーに公開されます。 | |
| ページスコープID (PSID) | https://developers.facebook.com/docs/messenger-platform/reference/webhook-events/messages | Facebook Messengerでメッセージを送信するには、ユーザーのPSIDが必要です。ユーザーがMessengerを介してアプリとやり取りするときに、FacebookによってPSIDが作成されます。このPSIDは、文字列カスタム属性としてBrazeに送信できます。 | |
| ページアクセストークン | https://developers.facebook.com/docs/messenger-platform/getting-started/app-setup#page_access_token | これらのアクセストークンは、Facebook Pageに属するデータの読み取り、書き込み、変更を行うAPIに権限を付与することを除き、ユーザーアクセストークンと似ています。ページアクセストークンを取得するには、ユーザーアクセストークンを取得し、manage_pagespermissionを要求する必要があります。ユーザーアクセストークンを取得したら、Graph APIを使用してページアクセストークンを取得できます。 |
統合
以下に、Braze Facebook Messenger Webhookの設定方法を示します。 ボットのセットアップに追加のヘルプが必要な場合は、Braze GitHubリポジトリに完全なMessengerボットチュートリアルとサンプルコードがあります。
ステップ1:PSIDを収集する
Facebook Messengerでメッセージを送信するには、ユーザーを識別し、一貫したやり取りを行うためにユーザーのページ固有のID (PSID) を収集する必要があります。PSIDはユーザーのFacebook IDとは異なります。顧客にメッセージを送信する場合または顧客からメッセージが送信される場合は常に、Facebookによりこの識別子が作成されます。
PSIDは、Facebookが提供するさまざまなエントリポイントの1つを使用して確認できます。ユーザーがアプリにメッセージを送ったり、ボタンをタップしたり、メッセージを送信したりといった対話のアクションを行った後は、そのPSIDがWebhookイベントのsender.idプロパティに含まれるため、ボットはアクションを行った人を識別できます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"sender":{
"id":"<PSID>"
},
"recipient":{
"id":"<PAGE_ID>"
},
"timestamp":1458692752478,
"message":{
"mid":"mid.1457764197618:41d102a3e1ae206a38",
"text":"hello, world!",
"quick_reply": {
"payload": "<DEVELOPER_DEFINED_PAYLOAD>"
}
}
}
メッセージを送信するたびに、そのPSIDがリクエストのrecipient.idプロパティに含まれ、メッセージを受信するユーザーを識別します。
ステップ2:カスタム属性としてBrazeに送信する
PSIDを受信していると確信したら、これを開発者と調整して共有し、カスタム属性としてPSIDをBrazeに送信します。PSIDは、APIコールでアクセスできる文字列です。
ステップ3:Webhookテンプレートをセットアップする
テンプレートとメディアからWebhookテンプレートに進み、Facebook Messenger Webhook Templateを選択します。
- テンプレートの名前を入力し、必要に応じてチームとタグを追加します。
- メッセージを入力するか、Facebookで利用可能なメッセージテンプレートからメッセージテンプレートを選択します。また、メッセージのタイプやタグを選択することもできます。
- カスタム属性としてPSIDを含めます。これを行うには、Request Bodyボックスの隅にある、青と白の+ボタンを使用します。
FACEBOOK_PAGE_ACCESS_TOKENをトークンに置き換えて、Webhook URLにページアクセストークンを追加します。
Webhookのプレビューとテスト
メッセージを送信する前に、Webhookをテストしてください。Messenger IDがBrazeに保存されていることを確認し(または、それを見つけてカスタマイズしたユーザーとしてテストし)、プレビューを使用してテストメッセージを送信します。

メッセージが正常に受信された場合は、配信設定を構成できます。
この統合を使用する
セットアップが完了したら、この統合を使用してFacebook Messengerユーザーをターゲットにします。ユーザーの電話番号を使用してメッセージを送信しておらず、Messengerメッセージを繰り返し送信する予定がある場合は、Messenger IDがカスタム属性として存在するすべてのユーザーに対してSegmentを作成し、分析トラッキングをオンにして、Messengerのサブスクリプション率を経時的に追跡する必要があります。

Messengerサブスクライバー向けの特定のSegmentを作成しない場合は、エラーを避けるために、既存のMessenger IDのフィルターを必ず含めてください。
他のセグメンテーションを使用してMessenger Campaignsをターゲットにし、他のCampaignと同様にそれ以降のCampaign作成プロセスを実行することもできます。