作成
顧客やあなたのFacebookページに関心を示した人を対象としたメッセージを作成して送信することができます。
開始する前に
以下が必要です。
制限
メッセージに対する応答に送信APIが recipient_id
を含めないことがありますが、それはそのメッセージが受信者を識別するために recipient.user_ref
または recipient.phone_number
を使用して送信された場合であることに注意してください。
リクエストの例
特定の人にメッセージを送信するには、messaging_type
パラメーターとrecipient
パラメーターを指定したPOST
リクエストを、メッセージコンテンツと共に/PAGE-ID/messsages
エンドポイントに送信します。
読みやすくするためにフォーマットを調整しています。以下は、ユーザーのメッセージへの返信例です。ここで、ページから送信するのはテキストのみのメッセージです。
curl -X POST "https://graph.facebook.com/v21.0
/{PAGE_ID}/messages" \
-d "recipient={'id':'{PSID}'}" \
-d "messaging_type=RESPONSE" \
-d "message={'text':'hello, world'}" \
-d "access_token={PAGE_ACCESS_TOKEN}"
成功すると、アプリは次のJSON応答を受け取ります。
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
パラメーター
パラメーター | 説明 | message object | ページが送信するメッセージのタイプ。このパラメーターを使うときは、text またはattachement のどちらかを設定する必要があります。 |
messaging_type enum必須 | 送信するメッセージのタイプ RESPONSE – 受信したメッセージに対する返信メッセージ。これには、 24時間の標準メッセージ時間枠内で送信される、宣伝メッセージと非宣伝メッセージが含まれます。例えば、ユーザーから予約確認やステータスの最新情報を求められたら、このタグを使用して返信します。 UPDATE – 受信したメッセージへの返信としてではなく、先を見越して送信されるメッセージ。 24時間の標準メッセージ時間枠内で送信される宣伝メッセージと非宣伝メッセージもこれに該当します。
|
notification_type enum | ユーザーが受け取るプッシュ通知のタイプ |
recipient object必須 | ページが送信するメッセージの受信者 id – 過去24時間以内にあなたのページが受信したメッセージに返信するために使用されるユーザーのページスコープID、または24時間の標準メッセージ時間枠外であなたのページからメッセージを受け取ることに同意したユーザーのページスコープID
user_ref – チェックボックスまたはカスタマーチャットプラグインへの返信としてメッセージを送信するために使用されるユーザーのリファレンス
comment_id – あなたのページ投稿への訪問者のコメントに対する非公開返信としてメッセージを送信するために使用されるコメントのID
post_id – あなたのページへの訪問者の投稿に対する非公開返信としてメッセージを送信するために使用されるページ投稿のID
|
sender_action enum | メッセージ時間枠内に表示されるアクションアイコン。ページがユーザーから受信したメッセージに対して実行するアクションを表します。 typing_on – ページが返信を準備しているときに、入力中の吹き出しを表示する
typing_off – 入力中の吹き出しを表示しない
mark_seen – ページに表示されたメッセージを示す既読アイコンを表示する
recipient パラメーターでのみ送信できます。message パラメーターでは送信できません。また、個別のリクエストとして送信する必要があります。
|
tag enum | このタグが付いていれば、24時間の標準メッセージ時間枠外でも、ページからユーザーにメッセージを送信できます。 ACCOUNT_UPDATE – 顧客のアプリやアカウントに関する1回限りの最新情報として顧客に送信しているメッセージにタグ付けします。 許可されている用途についてご確認ください。InstagramメッセージAPIでは利用できません。 CONFIRMED_EVENT_UPDATE – 顧客が登録した、予定されているイベントに関するリマインダーとして、または進行中のイベントに関する最新情報として、顧客に送信しているメッセージにタグ付けします。 許可されている用途についてご確認ください。InstagramメッセージAPIでは利用できません。 HUMAN_AGENT – InstagramメッセージAPIの場合は必須。このタグが利用者へのメッセージに追加された場合、その人のメッセージにはヒューマンエージェントから返信できます。メッセージを送信できるのは、その人のメッセージを受信してから7日以内です。ヒューマンエージェントによるサポートの対象となるのは、標準のメッセージ時間枠内で解決できなかった問題です。 許可されている用途についてご確認ください。標準アクセスモードまたは開発モードでは、Human Agent アクセス許可を利用できません。ヒューマンエージェントタグを利用するには、その前にアプリレビュープロセスを完了する必要があります。アプリレビューの申請時に、アプリのエクスペリエンスでヒューマンエージェントタグをどのように活用するかについて、明確な説明とデモを提供してください。 POST_PURCHASE_UPDATE – 顧客の最近の購入に関する最新情報として顧客に送信しているメッセージに、タグ付けします。 許可されている用途についてご確認ください。InstagramメッセージAPIでは利用できません。
|
メッセージタグの用途
次の表は、各メッセージタグのメッセージのタイプを示します。
メッセージタグ | 使用方法 | ACCOUNT_UPDATE
| 許可された用途認められない用途(完全に網羅するものではありません)InstagramメッセージAPIでは利用できません。 |
CONFIRMED_EVENT_UPDATE
| 許可された用途ユーザーがスケジュールしている近日開催予定のクラス、予約、イベントに関するリマインダー 受け入れたイベントや予約に関するユーザーの予約や出席の確認 ユーザーの移動や旅程に関する通知(到着、キャンセル、荷物の遅延、その他の旅行ステータスの変更)
認められない用途(完全に網羅するものではありません)宣伝用コンテンツ(特売品、特典、クーポン、割引などを含むがそれらに限定されない) 利用者が登録していないイベントに関連するコンテンツ(例: イベントチケット購入のリマインダー、他のイベントとのクロスセル、ツアー日程など) 過去のイベントに関連するメッセージ Messengerで行われたやり取りと関係のない調査、アンケート、レビューに対するプロンプト
InstagramメッセージAPIでは利用できません。 |
CUSTOMER_FEEDBACK
| 許可された用途認められない用途(完全に網羅するものではありません)InstagramメッセージAPIでは利用できません。 |
HUMAN_AGENT
| 許可された用途認められない用途(完全に網羅するものではありません)自動メッセージ 利用者の問い合わせに関係のないコンテンツ
InstagramメッセージAPIでは必須。 |
POST_PURCHASE_UPDATE
| 許可された用途認められない用途(完全に網羅するものではありません)宣伝用コンテンツ(特売品、キャンペーン、クーポン、割引などを含むがそれらに限定されない) 商品やサービスのクロスセルやアップセルに関するメッセージ Messengerで行われたやり取りと関係のない調査、アンケート、レビューに対するプロンプト
InstagramメッセージAPIでは利用できません。 |