Facebook Messenger
Facebook Messenger は、世界で最も人気があるインスタントメッセージングプラットフォームの1つで、1か月あたりのアクティブユーザー数は10億にのぼります。ブランドはこのプラットフォームで、顧客とインテリジェントかつ自動的にやり取りするための魅力的なチャットボットを作成します。
Braze とFacebook の統合では、Messenger Platform API を介して Facebook Messenger のユーザーにメッセージを送信するために、Braze Webhook、セグメンテーション、パーソナライゼーション、トリガー機能が利用されます。カスタム Facebook Messenger Webhook テンプレートは、Braze プラットフォームの [テンプレート] > [Webhook テンプレート] にあります。
古いナビゲーションを使用している場合は、「Engagement(エンゲージメント)」>「Templates & Media(テンプレート&メディア)」>「Webhook Templates(ウェブフック・テンプレート)」と進む。
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ボットが、私たちの方針と機能を期待どおりに遵守し、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 によりこの ID が作成されます。
PSID は、Facebook が提供するさまざまなエントリポイントの1つを使用して確認できます。ユーザーがアプリにメッセージを送ったり、ボタンをアプリしたり、メッセージを送信したりといった対話のアクションを受け取った後は、そのPSIDがsender.id
プロパティのWebhookの行動に含まれるため、ボットはアクションを受けた人を識別できます。
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 テンプレートのセットアップ
Templates & MediaからWebフックテンプレートに進み、FaceBook Messenger Webフックテンプレートを選択します。
- テンプレートの名前を入力し、必要に応じてチームとタグs を追加します。
- メッセージを入力するか、Facebook で利用可能なメッセージテンプレートからメッセージテンプレートを選択します。また、タイプやタグを選択することもできます。
- カスタム属性としてPSID を含めます。これを行うには、Request Bodyボックスの隅にある、青と白の+ボタンを使用します。
FACEBOOK_PAGE_ACCESS_TOKEN
をトークンに置き換えて、Webhook URL にページアクセストークンを追加します。
Webhookのプレビューとテスト
Webhookを確認してから送信してください。Messenger ID がBraze に保存されていることを確認し(または、それを見つけてカスタマイズしたユーザーとしてテストする)、プレビューを使用してテストメッセージを送信します。
メッセージが正常に受信された場合は、配信設定s を設定できます。
この統合を使う
設定が完了したら、この統合を使用して Facebook Messenger ユーザーをターゲットにします。ユーザーの電話番号を使用してメッセージを送信しておらず、Messenger メッセージを繰り返し送信する予定がある場合は、Messenger ID がカスタム属性として存在するすべてのユーザーに対してセグメントを作成し、分析の追跡をオンにして、Messenger のサブスクリプション率を経時的に追跡する必要があります。
Messenger サブスクライバー向けの特定のセグメントを作成しない場合は、エラーを避けるために、既存の Messenger ID のフィルターを必ず含めてください。
他のセグメンテーションを使用して Messenger キャンペーンをターゲットにし、他のキャンペーンと同様にそれ以降のキャンペーン作成プロセスを実行することもできます。