Facebook Messenger コネクタ構成ガイド

この記事では、Facebook Messengerコネクタの構成方法について説明します。

API情報

このコネクタは以下のベンダーAPIを使用します：

API名: Facebook Graph API - Messenger Platform
APIバージョン: v20.0
APIエンドポイント: https://graph.facebook.com
ドキュメンテーション: Facebookページ用ページアクセストークン

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を行います：

ページアクセストークン
このトークンはMessenger APIの呼び出しに使用されます。
詳細については、Facebook: ページアクセストークンを参照してください。

アクション

アクション名	AudienceStream	EventStream
テキストのみのメッセージを送信	✓	✗
メディアメッセージを送信	✓	✗
送信者アクションを送信	✓	✗
テンプレートメッセージ（高度）を送信	✓	✗

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

テキストのみのメッセージを送信

パラメータ

パラメータ	説明
メッセージングタイプ	必須。送信されるメッセージのメッセージングタイプを指定し、ボットが特定のメッセージングタイプのポリシーを遵守し、ユーザーの構成を尊重することを明示的に保証します。詳細については、Facebook: メッセージングタイプを参照してください。
受信者識別子	必須。メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーRefを構成する必要があります。受信者を識別するために電話番号を使用する場合、ボットはカスタマーマッチングの承認を受け、国コード、地域コード、番号（例：`16505551212`）のみを含める必要があります。電話番号を使用する場合、姓と名を構成することも可能です。
メッセージテキスト	必須。ユーザーに送信するメッセージの内容。このフィールドは2000文字に制限されています。このフィールドはTealiumテンプレートエンジンもサポートしています。詳細については、Trimouテンプレートエンジンを参照してください。
メッセージテキストテンプレート変数	メッセージデータのテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。
クイックリプライ	クイックリプライは、タイトルとオプションの画像を含む最大11個のボタンを会話中に表示する方法を提供し、コンポーザーの上に目立つように表示されます。ユーザーの位置情報、メールアドレス、電話番号のリクエストにもクイックリプライを使用できます。配列属性のみがサポートされ、ここで指定される配列は同じサイズでなければなりません。詳細については、Facebook: クイックリプライドキュメンテーションを参照してください。
メタデータ	Facebook Messenger Webhookを通じて配信されるカスタム文字列。1,000文字制限。メタデータは自動的にテンプレート機能とテンプレート変数をサポートします。詳細については、Trimouテンプレートエンジンを参照してください。
メタデータテンプレート変数	メタデータのテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。
通知タイプ	プッシュ通知のタイプ。通常: 音/振動（構成されていない場合は使用されます）。サイレントプッシュ: 画面上の通知のみ。プッシュなし: 通知なし .
メッセージタグ	メッセージングタイプが`メッセージタグ`に構成されている場合に使用します。すべてのメッセージタグの完全なリストについては、Facebook: メッセージタグドキュメンテーションを参照してください。

メディアメッセージを送信

パラメータ

パラメータ	説明
メッセージングタイプ	必須。送信されるメッセージのメッセージングタイプを指定し、ボットが特定のメッセージングタイプのポリシーを遵守し、ユーザーの構成を尊重することを明示的に保証します。詳細については、Facebook: メッセージングタイプを参照してください。
受信者識別子	必須。メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーRefを構成する必要があります。受信者を識別するために電話番号を使用する場合、ボットはカスタマーマッチングの承認を受け、国コード、地域コード、番号（例：`16505551212`）のみを含める必要があります。電話番号を使用する場合、姓と名を構成することも可能です。
メディアタイプ	必須。受信者に送信するメディアのタイプ。サポートされる値は`画像`、`音声`、`ビデオ`、または`ファイル`です。
メディアURL	必須。送信するメディアのウェブ`URL`アドレス。
再利用可能	このオプションを選択して、他の受信者に送信できる再利用可能なコンテンツとしてコンテンツをマークします。
クイックリプライ	クイックリプライは、タイトルとオプションの画像を含む最大11個のボタンを会話中に表示する方法を提供し、コンポーザーの上に目立つように表示されます。ユーザーの位置情報、メールアドレス、電話番号のリクエストにもクイックリプライを使用できます。配列属性のみがサポートされ、ここで指定される配列は同じサイズでなければなりません。詳細については、Facebook: クイックリプライドキュメンテーションを参照してください。
メタデータ	Facebook Messenger Webhookを通じて配信されるカスタム文字列。1,000文字制限。メタデータは自動的にテンプレート機能とテンプレート変数をサポートします。詳細については、Trimouテンプレートエンジンを参照してください。
メタデータテンプレート変数	メタデータのテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。
通知タイプ	プッシュ通知のタイプ。通常: 音/振動（構成されていない場合は使用されます）。サイレントプッシュ: 画面上の通知のみ。プッシュなし: 通知なし .
メッセージタグ	メッセージングタイプが`メッセージタグ`に構成されている場合に使用します。すべてのメッセージタグの完全なリストについては、Facebook: メッセージタグドキュメンテーションを参照してください。

送信者アクションを送信

パラメータ

パラメータ	説明
メッセージングタイプ	必須。送信されるメッセージのメッセージングタイプを指定し、ボットが特定のメッセージングタイプのポリシーを遵守し、ユーザーの構成を尊重することを明示的に保証します。詳細については、Facebook: メッセージングタイプを参照してください。
受信者識別子	必須。メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーRefのいずれかを構成する必要があります。受信者を識別するために電話番号を使用する場合、あなたのボットは顧客マッチングの承認が必要で、国コード、地域コード、番号（例えば、`16505551212`）のみを含める必要があります。電話番号を使用する場合、姓と名を構成することも可能です。
送信者アクション	必須。受信者に表示する送信者のアクション。サポートされている値は`typing_on`、`typing_off`、または`mark_seen`です。
メッセージタグ	メッセージタイプが`Message Tag`に構成されている場合に使用します。すべてのメッセージタグの完全なリストについては、Facebook: メッセージタグのドキュメンテーションを参照してください。

テンプレートメッセージの送信（アドバンス）

パラメータ

パラメータ	説明
メッセージタイプ	必須。送信されるメッセージのメッセージタイプを指定し、ボットが特定のメッセージタイプのポリシーを遵守し、ユーザーの構成を尊重するように明示的にします。詳細については、Facebook: メッセージタイプを参照してください。
受信者識別子	必須。メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーRefのいずれかを構成する必要があります。受信者を識別するために電話番号を使用する場合、あなたのボットは顧客マッチングの承認が必要で、国コード、地域コード、番号（例えば、`16505551212`）のみを含める必要があります。電話番号を使用する場合、姓と名を構成することも可能です。
テンプレートペイロード	必須：送信するテンプレートペイロード。ペイロードはテンプレート機能とテンプレート変数をサポートします。JSONとしてフォーマットする必要があります：`{ "template_type": "<TEMPLATE_TYPE>", ... }`。特定のペイロード内容については、メッセージテンプレートのドキュメンテーションを参照してください。
テンプレート変数	テンプレートエンジンを使用する場合、テンプレート変数が使用されます。これらのフィールドは、属性をテンプレートペイロードで使用される変数名にマッピングします。詳細については、テンプレート変数ガイドを参照してください。
クイックリプライ	クイックリプライは、タイトルとオプションの画像を含む最大11個のボタンを会話中に表示する方法を提供します。これらはコンポーザーの上に目立つように表示されます。また、クイックリプライを使用してユーザーの位置情報、メールアドレス、電話番号をリクエストすることもできます。配列属性のみがサポートされ、ここで指定される配列は同じサイズでなければなりません。詳細については、Facebook: クイックリプライのドキュメンテーションを参照してください。
メタデータ	Facebook Messenger Webhookの`message_echoes`フィールドを通じて配信されるカスタム文字列。1,000文字制限。メタデータは自動的にテンプレート機能とテンプレート変数をサポートします。詳細については、Trimouテンプレートエンジンを参照してください。
メタデータテンプレート変数	メタデータのテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。
通知タイプ	プッシュ通知のタイプ。通常: 音/振動（構成されていない場合は使用されます）。サイレントプッシュ: 画面上の通知のみ。プッシュなし: 通知なし。
メッセージタグ	メッセージタイプが`Message Tag`に構成されている場合に使用します。すべてのメッセージタグの完全なリストについては、Facebook: メッセージタグのドキュメンテーションを参照してください。

ベンダードキュメンテーション

API

Facebook Send HTTP API

Facebook オフラインコンバージョン

Facebook Audiences

このページはお役にたちましたでしょうか？

最終更新日 :: 2024年August月28日