Messenger Send API: Facebook ページからメッセージを送信する
Facebook ページは、POST /{page-id}/messages とページアクセストークンを使って Messenger メッセージを送信します。受信者には、ページスコープ ID(PSID)を指定します。messaging_type は、標準のメッセージングウィンドウ内では RESPONSE または UPDATE、ウィンドウを過ぎた後は MESSAGE_TAG とします。message には、テキスト、または画像、音声、動画、ファイルなどの添付を含めます。Meta は recipient_id と message_id を返します。
easyCoexistence は、Claude、ChatGPT、またはご自身のコードから send_social_dm を使い、24 時間ウィンドウ内で Messenger の DM にテキストで返信します。
アプリがページごとに、テキスト、リンク、リアクション、スタンプを含むメッセージに対して行える Send API の呼び出し回数。
アプリがページごとに、音声または動画を含むメッセージに対して行える Send API の呼び出し回数。
Messenger Platform が再利用のために保存する最大のアセット。URL からアップロードした画像は 8 MB が上限です。
1 件のメッセージの attachments 配列に含められる画像の最大数。同配列で使用できる唯一のメディアタイプです。
保存済みの attachment_id が有効な期間。この期間を過ぎると、メディアを再度アップロードする必要があります。
Send API のリクエストには何が含まれますか?
Meta は送信に必要な 6 つの要素を挙げています。送信元の Facebook ページの ID、受信者の ID、そのページのページアクセストークン、受信者からの許可、メッセージタイプ、そしてコンテンツです。リクエストは /{page-id}/messages への JSON による POST で、直前にメッセージを送ってきた相手への返信は次のようになります:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }recipient にはどの ID を指定しますか?
通常は、Meta が人物に対して初めてページへメッセージを送ったときに割り当てる、ページスコープ ID(PSID)を指定します。これは messages Webhook の sender.id として届きます。recipient オブジェクトは、特定のケースで次のような他の種類の ID も受け付けます:
- id: PSID。その人物とそのページに固有の ID です。
user_ref: プラグインやポストバックボタンを使ってページにメッセージを送った人物向けです。comment_idまたはpost_id: コメントや訪問者の投稿に対するプライベートリプライ用です。- Facebook Login の ID はアプリスコープで、Messenger Platform では使用できません。
メッセージにはどの messaging_type を使うべきですか?
このタイプは、Meta にそのメッセージを送る理由を伝えるもので、送信が許可されるタイミングを決めます。Meta の Page メッセージのリファレンスには 4 つの値が挙げられています:
- RESPONSE: ページが受信したメッセージへの返信。プロモーションかどうかは問わず、標準のメッセージングウィンドウ内で送ります。
- UPDATE: ページが自発的に送るメッセージ。プロモーションかどうかは問わず、同じくウィンドウ内で送ります。
MESSAGE_TAG: ウィンドウを過ぎた後に、承認済みのユースケースに一致するタグを付けて送る、プロモーション以外のメッセージ。- UTILITY: 注文や予約の更新など、承認済みのテンプレートから作成するユーティリティメッセージ。
メッセージには何を含められますか?
テキスト、または type と ペイロード を持つ添付オブジェクト 1 つを含められます。画像、音声、動画、ファイルの添付は URL または保存済みの attachment_id を指定します。テンプレート添付は、ボタン付きの構造化されたメッセージを運びます。同じエンドポイントでは、次の項目も指定できます:
- attachments: 1 件のメッセージとして送信される、最大 30 枚の画像の配列。
reply_toと mid: 過去の特定のメッセージ(相手のものでもページのものでも)への返信。quick_replies: 入力欄の上に表示される最大 13 個のボタン。各タイトルは 20 文字まで。sender_action: 入力中インジケーター、既読マーク、リアクション。メッセージ本体とは別のリクエストで送信します。notification_type: 既定は REGULAR。SILENT_PUSHまたはNO_PUSHも指定できます。
添付ファイルの上限サイズはどれくらいですか?
Meta のアセット保存ガイドでは、Messenger Platform が取得して保持するメディアの上限を定めています。アセットは最大 25 MB、URL からアップロードする場合の画像は最大 8 MB、audio Content-Type で送信する音声、そして 75 秒以内に取得される動画です。is_reusable を true に設定すると、送信元のページだけが再利用できる attachment_id が返され、有効期間は 90 日間です。POST /{page-id}/message_attachments を使うと、メディアを事前にアップロードできます。
Send API のレート制限はどのようになっていますか?
Meta は、ページごと、およびコンテンツの種類ごとに制限を数えます。送信エラーには、コード 613(「この API の呼び出しがレート制限を超えました」)が含まれています。これが表示されたら、すぐに再試行せず、速度を落としてください:
- テキスト、リンク、リアクション、スタンプを含むメッセージは、ページごとに毎秒 300 回まで。
- 音声または動画を含むメッセージは、ページごとに毎秒 10 回まで。
- 1 つのスレッドに送るメッセージが多すぎると、それ単独でもレート制限されることがあります。
- Messenger API の呼び出し総数は、24 時間のローリング期間で、エンゲージしたユーザー数の 200 倍までです。
- 毎秒 40 件を超えると、ページの受信トレイに新しいメッセージが表示されなくなり、量が減るまでページから送信できません。
Send API はどのエラーを返しますか?
Meta の Messenger エラー表は、各コードに原因を示すサブコードを組み合わせています。ページが送信時に最もよく遭遇するのは次のエラーです:
- 10 と 2018278 または 2534022: このメッセージは、許可されたウィンドウの外で送信されています。
- 10 と 2018300: 別のアプリが会話を管理しています。
- 100: 不正なパラメーター(受信者 ID の誤りなど)。サブコード 2018001 は「一致するユーザーが見つかりません」を示します。
- 551: 相手が利用できない状態です(ページをブロックした、またはアカウントを無効化した可能性があります)。200 と 1545041 は「この人物は現在利用できません」を示します。
- 200 と 2018028:
pages_messagingが審査され、アプリが公開されるまで、アプリはロールを持たない人物にメッセージを送ることができません。 - 10904: ページの設定でメッセージが無効になっています。
easyCoexistence はどのように送信しますか?
send_social_dm は account_id、受信者の recipient_id(転送された messages イベントの sender.id)、テキストを受け取り、messaging_type RESPONSE で /{page-id}/messages に送信します。結果は Meta の応答で、message_id が含まれます。拒否された送信は、Meta のエラーコードとメッセージとともに返されます。メディア、クイックリプライ、テンプレート、送信アクションはツールに含まれていません。send_social_dm が送信するのはテキストです。
よくある間違い
- 入力中インジケーターをメッセージと同じリクエストで送ること。Meta は sender_action を受信者と単独で送ることを求め、テキストやテンプレートは別のリクエストにするよう求めています。
- 1 人に短時間で連続送信すること。Meta はページの毎秒 300 回の上限とは別に、1 つのスレッドを単独でレート制限することがあります。
- 音声や動画を、テキストと同じ速度で送ること。音声または動画のメッセージは、ページごとに毎秒 10 回までに制限されています。
- 90 日より古い attachment_id を再利用すること。保存済みの添付 ID は期限が切れるため、新しい ID を得るにはメディアを再アップロードしてください。
メディア、クイックリプライ、テンプレートは対象外です。自動化機能では、固定テキストまたは AI による返信で、新しいメッセージに自動的に返信できます。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
Messenger Send API は無料ですか?
はい、通常のメッセージについてはそうです。Meta の概要では Messenger Platform は無料で利用できるとされており、ページがメッセージを送ってきた相手に返信しても、メッセージごとの料金はかかりません。マーケティングメッセージは、メッセージごとに課金されます。
Facebook ページからメッセージを送るには、どのページタスクが必要ですか?
Meta の Messenger 概要では、MESSAGING と MODERATE のタスクを実行できる人物のページトークンと、pages_messaging 権限の付与が必要とされています。
easyCoexistence で Messenger に画像を返信できますか?
現在はできません。send_social_dm はテキストを送信し、添付ファイルを送信するツールはありません。
Facebook ページの easyCoexistence の料金はいくらですか?
接続する Facebook ページはそれぞれ 1 接続として数えられ、接続 1 件あたり月額 US$ 9 から US$ 0.75 まで(接続数が増えるほど下がります)です。最初の 3 日間は無料です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日