ログイン無料トライアルを開始
easyCoexistence 公式 API

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 にテキストで返信します。

300 per second

アプリがページごとに、テキスト、リンク、リアクション、スタンプを含むメッセージに対して行える Send API の呼び出し回数。

10 per second

アプリがページごとに、音声または動画を含むメッセージに対して行える Send API の呼び出し回数。

25 MB

Messenger Platform が再利用のために保存する最大のアセット。URL からアップロードした画像は 8 MB が上限です。

30 images

1 件のメッセージの attachments 配列に含められる画像の最大数。同配列で使用できる唯一のメディアタイプです。

90 days

保存済みの attachment_id が有効な期間。この期間を過ぎると、メディアを再度アップロードする必要があります。

Send API のリクエストには何が含まれますか?

Meta は送信に必要な 6 つの要素を挙げています。送信元の Facebook ページの ID、受信者の ID、そのページのページアクセストークン、受信者からの許可、メッセージタイプ、そしてコンテンツです。リクエストは /{page-id}/messages への JSON による POST で、直前にメッセージを送ってきた相手への返信は次のようになります:

A text reply, and Meta's answer
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 を得るにはメディアを再アップロードしてください。
EasyCoexistence で実現する

メディア、クイックリプライ、テンプレートは対象外です。自動化機能では、固定テキストまたは 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 監視

確認日