API で Messenger の会話履歴を読み取る
Facebook Page の Messenger 履歴は、GET /{page-id}/conversations?platform=messenger で読み取ります。これは会話 ID と最終更新時刻の一覧を返します。続いて GET /{conversation-id}?fields=messages でメッセージ ID を取得し、GET /{message-id} で各メッセージの送信者、受信者、テキスト、添付ファイルを取得します。Meta は会話ごとに直近 20 件のメッセージの詳細のみを返し、呼び出しには pages_messaging を持つ Page アクセストークンが必要です。
easyCoexistence は、Page の新しい Messenger メッセージを届き次第お使いのエンドポイントへ転送し、Claude、ChatGPT、またはご自身のコードから send_social_dm で 24 時間の返信可能期間内に返信します。
会話で詳細が返るのは直近 20 件のメッセージだけです。それより古いメッセージはエラーになり、削除されたことを示します。
1 つの Facebook Page に対して、アプリが行える Conversations API の呼び出し数。
「リクエスト」フォルダーにあり、この期間非アクティブな会話は、API の結果から除外されます。
会話を読むために、トークンの持ち主が Page 上で実行できる必要があるタスク。
Page アカウントに対する Messenger API の呼び出しが多すぎる場合のエラーです。Meta は、しばらく待ってから再試行するよう案内しています。
Page の会話一覧は、どのように取得しますか。
GET /{page-id}/conversations を呼び出し、platform に messenger を指定します。結果には data 配列が含まれ、各要素は会話 ID と updated_time(最後にメッセージが追加された時刻)を持ちます。さらに paging オブジェクトも返ります。Meta のリファレンスによると、このエンドポイントでは時間によるページネーションを使えないため、paging オブジェクトをたどって一覧を進めてください。
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}1 人分の会話は、どのように見つけますか。
同じリクエストに user_id を追加し、値にその人の Page スコープ ID を指定します。Meta は、その Page とその人との間の会話 ID を返します。messages の webhook では PSID が sender.id として届くため、これは webhook からその背後にある履歴へ至る最短の経路です:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }会話内のメッセージは、どのように読みますか。
2 段階で読みます。まず GET /{conversation-id} に fields=messages を指定すると、会話のメッセージ ID が、created_time とともに最新のものから順に返ります。次に GET /{message-id} で必要なフィールド(id、created_time、from、to、message、reply_to など)を指定すると、1 件のメッセージの内容が返ります。既定のフィールドは id と created_time で、データのないフィールドはレスポンスから除外されます。
どのフィールドを読めますか。
会話とメッセージでは、取得できるフィールドが異なります。以下は Meta のリファレンスが Page のメッセージング向けに挙げているフィールドです。
- 会話: id、
updated_time、ID・名前・メールアドレスを持つ participants、messages、そして Conversation Routing を有効にしたときのis_owner。 - メッセージ: id、
created_time、ID・名前・メールアドレスを持つ from と to、そしてテキストである message(ない場合は空)。 - attachments: ファイル、画像、動画の CDN URL を含み、サポート対象外のコンテンツを含むメッセージでのみ返される
is_unsupported。 - reactions、返信先の mid と
is_self_replyを持つreply_to、共有投稿やリールのための shares。 - tags: メッセージのフォルダーと送信元(inbox、read、source:chat など)。
どこまで遡って読めますか。
ID は会話の最初まで読めますが、内容は直近の範囲に限られます。Meta のガイドによると、会話のエンドポイントは会話内のすべてのメッセージ ID を返しますが、詳細が返るのは直近 20 件のメッセージだけです。それより古いメッセージを指定すると、メッセージが削除されたというエラーが返ります。「リクエスト」フォルダーにあり、30 日間非アクティブな会話は、まったく返されません。
必要な権限とタスクは何ですか。
Page に対して MESSAGING または MODERATE のタスクを実行できる人物の Page アクセストークンが必要です。また、pages_manage_metadata、pages_read_engagement、pages_messaging の権限も必要です。アプリ、Page、またはビジネスに役割を持たない人との会話を読むには、Advanced Access が必要で、これは App Review を通じて Meta が付与します。
呼び出しにはどのような制限がありますか。
Meta のレート制限では、Conversations API は Page ごとに毎秒 2 回の呼び出しに制限されます。制限を超えた呼び出しは、613 または 80006 のエラーで返されます。エラーメッセージは「There have been too many messenger api calls to this Page account.」です。毎秒 40 件を超えるメッセージ送信など、Meta の高ボリューム制限に達した Page は、ボリュームが下がるまで会話一覧を取得できません。ただし、1 つの会話に対する新着メッセージの読み取りは引き続き可能です。
API と webhook はどう使い分けますか。
用途は過去のメッセージの取得です。webhook は新着メッセージを発生時に届けますが、過去の通知は後から照会できないと Meta は案内しています。そのため、Conversations API は、連携が受信を開始する前のメッセージを読んだり、停止後に取り込み直したりするための手段になります。Conversation Routing を有効にすると、is_owner フィールドで、アプリが返信を担当する会話に一覧を絞り込めます。Meta はこれを、停止後の復旧に使うことを勧めています。
easyCoexistence は Messenger の履歴をどのように読みますか。
履歴は読み取りません。Page は pages_messaging、pages_manage_metadata、pages_read_engagement の権限で接続されますが、Conversations API を呼び出すツールはなく、Page のトークンも渡されません。新着メッセージは届き次第、set_social_webhook_destination によってお使いのエンドポイントへ転送され、コピーは保持しないため、必要な履歴はお使いのシステム側で保持されます。
よくある間違い
- 会話一覧の呼び出しでメッセージの内容を期待すること。会話のエンドポイントが返すのはメッセージ ID で、各メッセージのフィールドは /{message-id} から読みます。
- 履歴全体を当てにすること。詳細は直近 20 件で止まるため、必要なものは webhook でメッセージが届いたときに保存してください。
- 新着メッセージをポーリングすること。Page あたり毎秒 2 回では、ポーリングのループはすぐにレート制限に達します。一方、messages の webhook は発生時に届けます。
- since と until で日付により会話をページングすること。Conversations エンドポイントでは時間によるページネーションは利用できないため、代わりに paging オブジェクトをたどってください。
Conversations API 用のツールはないため、それ以前の履歴は Page インボックスで読みます。接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。
よくある質問
Conversations API には、Page 自身のメッセージも含まれますか。
はい。メッセージの from と to のフィールドには、相手または Page のどちらかが記録されるため、会話のメッセージには両方の側が含まれます。
App Review なしで Messenger の会話を読めますか。
アプリ、または Page に役割を持つ人には Standard Access で十分です。それ以外の人との会話には Advanced Access が必要で、これは App Review を通じて付与されます。
Conversations API で返信を送れますか。
いいえ。Meta の会話のリファレンスによると、このエッジは投稿できません。返信は /{page-id}/messages の Send API を使います。
easyCoexistence は Messenger の会話を保存しますか。
既定では保持しません。転送されたイベントは、コピーを保持せずそのまま転送します。オートメーションを有効にしている場合、メッセージのテキストは 7 日間、オートメーションの実行ログは 30 日間保持されます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日