Facebook Messengerコネクタの構成ガイド

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

必要条件

• ページアクセストークンアカウント（アクセストークンの場所がわからない場合は、こちらから始めてください）

サポートされるアクション

構成の構成

コネクタマーケットプレイスに移動し、新しいFacebook Messengerコネクタを追加します。コネクタの追加方法の一般的な手順については、コネクタの概要の記事をお読みください。

ベンダーを構成するには、次の手順に従ってください。

1. 構成タブで、コネクタインスタンスのタイトルを入力します。

2. Facebookアカウントからページアクセストークンを入力します。

3. 実装に関する追加のノートを提供します。

アクションの構成 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでアクションを構成し、トリガーを構成します。

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

アクション - テキストのみのメッセージを送信

パラメータ

1. メッセージングタイプ（必須）：メッセージングタイププロパティは、送信されるメッセージのメッセージングタイプを識別し、ボットが特定のメッセージングタイプのポリシーに準拠し、人々の構成を尊重していることを明示するためのより明示的な方法です。詳細については、Facebookのメッセージングタイプのドキュメントを参照してください。
2. 受信者識別子（必須）：メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーの参照を構成する必要があります。受信者を識別するために電話番号を使用する場合、ボットは顧客マッチングに承認されている必要があります。電話番号を使用する場合、名前と姓も構成できます。
3. メッセージテキスト（必須）：ユーザーに送信するメッセージの内容です。このフィールドは2000文字に制限されています。このフィールドはTealiumのテンプレートエンジンもサポートしています。
4. メッセージテキストのテンプレート変数（オプション）：テンプレートエンジンを使用する場合、テンプレート変数が使用されます。これらのフィールドは、メッセージテキストで使用される属性を変数名にマッピングします。（テンプレート変数ガイドを参照してください）
5. クイックリプライ（オプション）：クイックリプライは、会話中に表示される最大11個のボタンを含むタイトルとオプションの画像を提供し、コンポーザの上部に目立つ形で表示されます。また、クイックリプライを使用して、場所、メールアドレス、電話番号を要求することもできます。配列属性のみがサポートされています。各配列の長さは同じでなければなりません。クイックリプライについての詳細は、クイックリプライのドキュメントを参照してください。
6. メタデータ（オプション）：Facebookウェブフックmessage_echoesに送信するメタデータ。このフィールドは1000文字に制限されています。このフィールドはTealiumのテンプレートエンジンもサポートしています。
7. メタデータのテンプレート変数（オプション）：テンプレートエンジンを使用する場合、テンプレート変数が使用されます。これらのフィールドは、メタデータで使用される属性を変数名にマッピングします。（テンプレート変数ガイドを参照してください）
8. 通知タイプ（オプション）：プッシュ通知のタイプ。構成されていない場合、デフォルトはREGULARで、音と振動です。SILENT_PUSHは振動のない画面上の通知のみを表示します。NO_PUSHは通知を表示しません。
9. メッセージタグ（オプション）：MESSAGE_TAGメッセージングタイプを使用する場合、このフィールドを構成する必要があります。すべてのメッセージタグの完全なリストについては、メッセージタグのドキュメントを参照してください。

アクション - メディアメッセージを送信

パラメータ

1. メッセージングタイプ（必須）：メッセージングタイププロパティは、送信されるメッセージのメッセージングタイプを識別し、ボットが特定のメッセージングタイプのポリシーに準拠し、人々の構成を尊重していることを明示するためのより明示的な方法です。詳細については、Facebookのメッセージングタイプのドキュメントを参照してください。
2. 受信者識別子（必須）：メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーの参照を構成する必要があります。受信者を識別するために電話番号を使用する場合、ボットは顧客マッチングに承認されている必要があります。電話番号を使用する場合、名前と姓も構成できます。
3. メディアタイプ（必須）：送信するメディアメッセージのタイプです。画像、音声、ビデオ、またはファイルのいずれかです。
4. メディアURL（オプション）：送信するメディアのURLです。
5. 再利用可能かどうか（オプション）：コンテンツを他の受信者に送信できるようにするかどうかを構成します。
6. クイックリプライ（オプション）：クイックリプライは、会話中に表示される最大11個のボタンを含むタイトルとオプションの画像を提供し、コンポーザの上部に目立つ形で表示されます。また、クイックリプライを使用して、場所、メールアドレス、電話番号を要求することもできます。配列属性のみがサポートされています。各配列の長さは同じでなければなりません。クイックリプライについての詳細は、クイックリプライのドキュメントを参照してください。
7. メタデータ（オプション）：Facebookウェブフックmessage_echoesに送信するメタデータ。このフィールドは1000文字に制限されています。このフィールドはTealiumのテンプレートエンジンもサポートしています。
8. メタデータのテンプレート変数（オプション）：テンプレートエンジンを使用する場合、テンプレート変数が使用されます。これらのフィールドは、メタデータで使用される属性を変数名にマッピングします。（テンプレート変数ガイドを参照してください）
9. 通知タイプ（オプション）：プッシュ通知のタイプ。構成されていない場合、デフォルトはREGULARで、音と振動です。SILENT_PUSHは振動のない画面上の通知のみを表示します。NO_PUSHは通知を表示しません。
10. メッセージタグ（オプション）：MESSAGE_TAGメッセージングタイプを使用する場合、このフィールドを構成する必要があります。すべてのメッセージタグの完全なリストについては、メッセージタグのドキュメントを参照してください。

アクション - 送信者アクションを送信

パラメータ

1. メッセージングタイプ（必須）：メッセージングタイププロパティは、送信されるメッセージのメッセージングタイプを識別し、ボットが特定のメッセージングタイプのポリシーに準拠し、人々の構成を尊重していることを明示するためのより明示的な方法です。詳細については、Facebookのメッセージングタイプのドキュメントを参照してください。
2. 受信者識別子（必須）：メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーの参照を構成する必要があります。受信者を識別するために電話番号を使用する場合、ボットは顧客マッチングに承認されている必要があります。電話番号を使用する場合、名前と姓も構成できます。
3. 送信者アクション（必須）：受信者に表示する送信者アクションです。typing_on、typing_off、またはmark_seenのいずれかです。
4. メッセージタグ（オプション）：MESSAGE_TAGメッセージングタイプを使用する場合、このフィールドを構成する必要があります。すべてのメッセージタグの完全なリストについては、メッセージタグのドキュメントを参照してください。

アクション - テンプレートメッセージを送信（高度な構成）

パラメータ

1. メッセージングタイプ（必須）：メッセージングタイププロパティは、送信されるメッセージのメッセージングタイプを識別し、ボットが特定のメッセージングタイプのポリシーに準拠し、人々の構成を尊重していることを明示するためのより明示的な方法です。詳細については、Facebookのメッセージングタイプのドキュメントを参照してください。
2. 受信者識別子（必須）：メッセージを送信する受信者を識別します。ID、電話番号、またはユーザーの参照を構成する必要があります。受信者を識別するために電話番号を使用する場合、ボットは顧客マッチングに承認されている必要があります。電話番号を使用する場合、名前と姓も構成できます。
3. テンプレートペイロード（必須）：受信者に送信するテンプレートペイロードデータです。JSON形式で次のようにフォーマットする必要があります：{ "template_type": "<TEMPLATE_TYPE>", ... }（詳細は、メッセージテンプレートのドキュメントを参照してください）
4. テンプレート変数（オプション）：テンプレートエンジンを使用する場合、テンプレート変数が使用されます。これらのフィールドは、テンプレートペイロードで使用される属性を変数名にマッピングします。（テンプレート変数ガイドを参照してください）
5. クイックリプライ（オプション）：クイックリプライは、会話中に表示される最大11個のボタンを含むタイトルとオプションの画像を提供し、コンポーザの上部に目立つ形で表示されます。また、クイックリプライを使用して、場所、メールアドレス、電話番号を要求することもできます。配列属性のみがサポートされています。各配列の長さは同じでなければなりません。クイックリプライについての詳細は、クイックリプライのドキュメントを参照してください。
6. メタデータ（オプション）：Facebookウェブフックmessage_echoesに送信するメタデータ。このフィールドは1000文字に制限されています。このフィールドはTealiumのテンプレートエンジンもサポートしています。
7. メタデータのテンプレート変数（オプション）：テンプレートエンジンを使用する場合、テンプレート変数が使用されます。これらのフィールドは、メタデータで使用される属性を変数名にマッピングします。（テンプレート変数ガイドを参照してください）
8. 通知タイプ（オプション）：プッシュ通知のタイプ。構成されていない場合、デフォルトはREGULARで、音と振動です。SILENT_PUSHは振動のない画面上の通知のみを表示します。NO_PUSHは通知を表示しません。
9. メッセージタグ（オプション）：MESSAGE_TAGメッセージングタイプを使用する場合、このフィールドを構成する必要があります。すべてのメッセージタグの完全なリストについては、メッセージタグのドキュメントを参照してください。

ベンダードキュメント

• ページアクセストークン
• メッセージングタイプ
• 顧客マッチング
• クイックリプライ
• メッセージタグ
• メッセージテンプレート

APIs

• Facebook Send HTTP API