Facebookメッセンジャーコネクタ構成ガイド
この記事では、Facebookメッセンジャーコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：Facebook Graph API - Messenger Platform
- APIバージョン：v22.0
- APIエンドポイント：
https://graph.facebook.com - ドキュメント：Facebookページのページアクセストークン
構成
コネクタマーケットプレイスに移動して新しいコネクタを追加します。コネクタの追加方法については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します：
- ページアクセストークン
- このトークンは、Messenger APIの呼び出しに使用されます。
- 詳細については、Facebook: ページアクセストークンを参照してください。
アクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| テキストのみのメッセージを送信 | ✓ | ✗ |
| メディアメッセージを送信 | ✓ | ✗ |
| 送信者アクションを送信 | ✓ | ✗ |
| テンプレートメッセージを送信（高度） | ✓ | ✗ |
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
テキストのみのメッセージを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| メッセージングタイプ | 必須。送信されるメッセージのメッセージングタイプを指定し、特定のメッセージングタイプに対するポリシーの遵守をより明確にし、人々の好みを尊重することを保証します。詳細については、Facebook: メッセージングタイプを参照してください。 |
| 受信者識別子 | 必須。メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーレフが構成されている必要があります。電話番号を使用して受信者を識別する場合、あなたのボットは顧客マッチングの承認を受け、国コード、エリアコード、番号（例：16505551212）のみを含む数字を使用する必要があります。電話番号を使用する場合、名と姓も構成することが可能です。 |
| メッセージテキスト | 必須。ユーザーに送信するメッセージの内容。このフィールドは2000文字に制限されています。このフィールドはTealiumテンプレートエンジンもサポートしています。詳細については、Trimouテンプレートエンジンを参照してください。 |
| メッセージテキストテンプレート変数 | メッセージデータのテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 |
| クイック返信 | クイック返信は、タイトルとオプションの画像を含む最大11個のボタンのセットを会話中に提示する方法を提供し、コンポーザーの上に目立って表示されます。また、クイック返信を使用してユーザーの位置情報、メールアドレス、電話番号を要求することもできます。サポートされているのは配列属性のみであり、ここで指定された配列は同じサイズである必要があります。詳細については、Facebook: クイック返信ドキュメントを参照してください。 |
| メタデータ | Facebook Messenger Webhookを通じてmessage_echoesフィールドで配信されるカスタム文字列。1,000文字制限。メタデータは自動的にテンプレート機能とテンプレート変数をサポートします。詳細については、Trimouテンプレートエンジンを参照してください。 |
| メタデータテンプレート変数 | メタデータのテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 |
| 通知タイプ | プッシュ通知のタイプ。
|
| メッセージタグ | メッセージングタイプがMessage Tagに構成されている場合に使用します。すべてのメッセージタグの完全なリストについては、Facebook: メッセージタグドキュメントを参照してください。 |
メディアメッセージを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| メッセージングタイプ | 必須。送信されるメッセージのメッセージングタイプを指定し、特定のメッセージングタイプに対するポリシーの遵守をより明確にし、ユーザーの好みを尊重することを保証します。詳細については、Facebook: メッセージングタイプを参照してください。 |
| 受信者識別子 | 必須。メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーレフが構成されている必要があります。電話番号を使用して受信者を識別する場合、あなたのボットは顧客マッチングの承認を受け、国コード、エリアコード、番号（例：16505551212）のみを含む数字を使用する必要があります。電話番号を使用する場合、名と姓も構成することが可能です。 |
| メディアタイプ | 必須。受信者に送信するメディアのタイプ。サポートされている値はImage、Audio、Video、またはFileです。 |
| メディアURL | 必須。送信されるメディアのウェブURLアドレス。 |
| 再利用可能 | このオプションを選択して、他の受信者に送信できる再利用可能なコンテンツとしてコンテンツをマークします。 |
| クイック返信 | クイック返信は、タイトルとオプションの画像を含む最大11個のボタンのセットを会話中に提示する方法を提供し、コンポーザーの上に目立って表示されます。また、クイック返信を使用してユーザーの位置情報、メールアドレス、電話番号を要求することもできます。サポートされているのは配列属性のみであり、ここで指定された配列は同じサイズである必要があります。詳細については、Facebook: クイック返信ドキュメントを参照してください。 |
| メタデータ | Facebook Messenger Webhookを通じてmessage_echoesフィールドで配信されるカスタム文字列。1,000文字制限。メタデータは自動的にテンプレート機能とテンプレート変数をサポートします。詳細については、Trimouテンプレートエンジンを参照してください。 |
| メタデータテンプレート変数 | メタデータのテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 |
| 通知タイプ | プッシュ通知のタイプ。
|
| メッセージタグ | メッセージングタイプがMessage Tagに構成されている場合に使用します。すべてのメッセージタグの完全なリストについては、Facebook: メッセージタグドキュメントを参照してください。 |
送信者アクションを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| メッセージングタイプ | 必須。送信されるメッセージのメッセージングタイプを指定し、特定のメッセージングタイプに対するポリシーの遵守とユーザーの構成を尊重するためのより明確な方法を提供します。詳細については、Facebook: メッセージングタイプを参照してください。 |
| 受信者識別子 | 必須。メッセージを送信する受信者を識別します。ID、電話番号、またはユーザー参照が構成されている必要があります。受信者を識別するために電話番号を使用する場合、あなたのボットはカスタマーマッチングの承認を受け、国コード、地域コード、番号（例：16505551212）のみを含む必要があります。電話番号を使用する場合、名と姓の構成も可能です。 |
| 送信者アクション | 必須。受信者に表示する送信者アクション。サポートされる値は typing_on、typing_off、または mark_seen です。 |
| メッセージタグ | メッセージングタイプが メッセージタグに構成されている場合に使用します。すべてのメッセージタグの完全なリストについては、Facebook: メッセージタグのドキュメントを参照してください。 |
テンプレートメッセージの送信（高度）
パラメータ
| パラメータ | 説明 |
|---|---|
| メッセージングタイプ | 必須。送信されるメッセージのメッセージングタイプを指定し、特定のメッセージングタイプに対するポリシーの遵守とユーザーの構成を尊重するためのより明確な方法を提供します。詳細については、Facebook: メッセージングタイプを参照してください。 |
| 受信者識別子 | 必須。メッセージを送信する受信者を識別します。ID、電話番号、またはユーザー参照が構成されている必要があります。受信者を識別するために電話番号を使用する場合、あなたのボットはカスタマーマッチングの承認を受け、国コード、地域コード、番号（例：16505551212）のみを含む必要があります。電話番号を使用する場合、名と姓の構成も可能です。 |
| テンプレートペイロード | 必須：送信されるテンプレートペイロード。ペイロードはテンプレート機能とテンプレート変数をサポートします。JSON形式でフォーマットされるべきです：{ "template_type": "<TEMPLATE_TYPE>", ... }。特定のペイロード内容については、メッセージテンプレートのドキュメントを参照してください。 |
| テンプレート変数 | テンプレートエンジンを使用する場合、テンプレート変数が使用されます。これらのフィールドは属性をテンプレートペイロードで使用される変数名にマッピングします。詳細については、テンプレート変数ガイドを参照してください。 |
| クイック返信 | クイック返信は、タイトルとオプションの画像を含む最大11個のボタンのセットを会話中に提示する方法を提供し、コンポーザーの上に目立って表示されます。クイック返信を使用して、ユーザーの位置情報、メールアドレス、電話番号を要求することもできます。サポートされるのは配列属性のみで、ここで指定される配列は同じサイズである必要があります。詳細については、Facebook: クイック返信のドキュメントを参照してください。 |
| メタデータ | Facebook Messenger Webhookを通じて message_echoes フィールドで配信されるカスタム文字列。1,000文字制限。メタデータは自動的にテンプレート機能とテンプレート変数をサポートします。詳細については、Trimou テンプレートエンジンを参照してください。 |
| メタデータテンプレート変数 | メタデータのためのテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 |
| 通知タイプ | プッシュ通知のタイプ。
|
| メッセージタグ | メッセージングタイプが メッセージタグに構成されている場合に使用します。すべてのメッセージタグの完全なリストについては、Facebook: メッセージタグのドキュメントを参照してください。 |
ベンダー文書
API
最終更新日 :: 2025年March月27日