「Messengerに送信」プラグイン
Facebookアプリが開発モードの場合、プラグインとAPIの機能は、有効なセッションに入っているアプリの管理者、開発者、テスト担当者にのみ動作します。アプリが承認されて公開された後は、一般の人にも動作するようになります。
Webhookの認証イベントをトリガーするには、「Messengerに送信」プラグインが使われます。データを渡してその認証イベントにどのユーザーとトランザクションが結び付けられていたかを知り、ユーザーをバックエンドでリンクすることができます。
このボタンをユーザーが初めてクリックすると、確認ポップアップが表示されます。
要件
Facebook JavaScript SDK
「Messengerに送信」プラグインを使うには、そのプラグインがレンダリングされるページの中に、Facebook for JavaScript SDKを含める必要があります。
SDKを含める手順については、Facebook for Javascript SDKクイックスタートをご覧ください。
設定
<div class="fb-send-to-messenger"
messenger_app_id="<APP_ID>"
page_id="PAGE_ID"
data-ref="<PASS_THROUGH_PARAM>"
color="<blue | white>"
size="<standard | large | xlarge>">
</div>利用可能な属性の詳しい説明については、「Messengerに送信」プラグインのリファレンスをご覧ください。
イベントサブスクリプション
プラグインイベントをサブスクリプション登録します。
<script>
FB.Event.subscribe('send_to_messenger', function(e) {
// callback for events triggered by the plugin
});
</script>イベントフィールド
| フィールド名 | 型 | 説明 |
|---|---|---|
| 列挙型 | イベントの名前。値は |
| 文字列 | プラグインの |
| ブーリアン | イベントが、確認ポップアップで確認された後に発生したものかどうかを示します。 |
| 未定義 | このフィールドは使われていません。 |
Webhookイベント
「Messengerに送信」プラグインは、messaging_optins Webhookイベントをトリガーします。
ログイン動作のカスタマイズ
ログインしているFacebookユーザーがいない場合、プラグインはユーザーIDを表示せずにレンダリングされます。ボタンをクリックすると、ユーザーにログインを促すプロンプトが表示されます。
allow_loginをfalseに設定すると、プラグインはログインしていないユーザーのレンダリングを行いません。
プラグインがFacebookセッションなしでレンダリングするのは、アプリが承認されて公開されている場合のみです。
CTAのテキストオプション
「Messengerに送信」プラグインでは、cta_text属性もサポートされています。それにより、事前定義されている文字列リストからプラグインのボタンテキストを選択できます。cta_text属性が使われている場合、サインイン済みユーザーの多くは、ポップアップで再確認しなくてもプラグインのボタンをクリックするだけでオプトインでき、messaging_optinsイベントがすぐに配信されます。
cta_text属性でサポートされている値は、次のとおりです。
GET_THIS_IN_MESSENGERRECEIVE_THIS_IN_MESSENGERSEND_THIS_TO_MEGET_CUSTOMER_ASSISTANCEGET_CUSTOMER_SERVICEGET_SUPPORTLET_US_CHATSEND_ME_MESSAGESALERT_ME_IN_MESSENGERSEND_ME_UPDATESMESSAGE_MELET_ME_KNOWKEEP_ME_UPDATEDTELL_ME_MORESUBSCRIBE_IN_MESSENGERSUBSCRIBE_TO_UPDATESGET_MESSAGESSUBSCRIBEGET_STARTED_IN_MESSENGERLEARN_MORE_IN_MESSENGERGET_STARTED