facebookAPIを用いてダイレクトメッセージを取得したいが、指定に必要なmessage-idの取得方法がわからない

Question

お世話になります。

叶えたいこと

FacebookのGraphAPIを用いて、Facebook上のDMをWebアプリ内に取得したいと考えております。

困っていること

公式のドキュメントを見ると、以下でメッセージ内容が取得できることがわかるのですが、
引数にメッセージIDを指定する必要があります。

そのメッセージIDを取得するにはどうすればよいか、
メッセージを取得するためのエンドポイントが存在するのか否かがわからず、
また、ググってみてもなかなかこれといった結果を得られなかったため、ご質問させていただきました。

FacebookAPI Message
https://developers.facebook.com/docs/graph-api/reference/v9.0/message
抜粋

  $response = $fb->get(
    '/{message-id}',
    '{access-token}'
  );

知見が浅く恐縮ですが、有識者の方いらっしゃいましたらお力をお借りいただけますと幸いでございます。
よろしくお願いいたします。

Answer 1

URLの上の方に以下の文言がありました

スレッドのエンドポイントまたはPages用のWebhooksを使用して個別のメッセージIDを取得します。

※　英語だと"Use the conversation thread endpoint"になっているのでAPI一覧からconversationを見ればいいと分かるのですが、日本語訳だと分かりづらいですね

こんな流れではないかと推測しています。

(1) /me/conversationsからconversation idのリストを取得
https://developers.facebook.com/docs/graph-api/reference/user/

/meノードは特別なエンドポイントで、現在アクセストークンがAPI呼び出しに使われている利用者のuser_id(またはFacebookページのpage_id)に変わります。ユーザーアクセストークンを持っていれば、次のコードでユーザーのすべての写真を取得できます。

(2) {conversation-id}からmessage idのリストを取得
https://developers.facebook.com/docs/graph-api/reference/v9.0/conversation

(3) /{message-id}からメッセージの内容を取得
https://developers.facebook.com/docs/graph-api/reference/v9.0/message

追記

別質問見ました。
確かにプライベートメッセージの取得は廃止されているようにみえます。
https://stackoverflow.com/questions/45614403/can-i-read-private-messages-with-the-facebook-api

In other words, there is no way to access the user messages (anymore).

https://stackoverflow.com/questions/11170189/get-a-facebook-users-inbox-messages/11171172

Yes, it seems to have been removed as of 2020. – user3738870 Nov 28 at 18:34

https://stackoverflow.com/questions/55060916/send-message-through-facebook-api-from-personal-account-to-a-page

No, that is not possible.
You can not automate sending user messages at all.

ユーザーメッセージBOTは作成できず、企業ページのメッセージBOTは作成できるようにみえました。
https://developers.facebook.com/docs/messenger-platform/introduction

Comments

[greentea_mmlg]

コメントいただきありがとうございます！

ご教示いただいた通りに進められそうな兆しでございます、ありがとうございますｍｍ
(2)のステップに差し掛かった際、FacebookAPIの権限が足りておらず追加で権限申請が必要となったため、申請が通り次第続きの実装を行い、結果をこちらでご報告させていただきたく思います。

まずは取り急ぎお礼を申し上げたく、コメントさせていただきました。
ありがとうございます。

[greentea_mmlg]

コメントいただきありがとうございます！
別の質問のほうまでご確認いただきありがとうございます。
大変助かりますｍｍ

> 確かにプライベートメッセージの取得は廃止されているようにみえます。
> ユーザーメッセージBOTは作成できず、企業ページのメッセージBOTは作成できるようにみえました。

上記、各種お調べいただき、またご丁寧におまとめいただきありがとうございます。

今後InstagramのMessage管理も行えるようになるようなので、そちらがリリースされるまではユーザのメッセージ取得はできない様子、というもので一旦の仮説としたいと思います。
https://developers.facebook.com/blog/post/2020/10/19/messenger-api-to-support-Instagram/

ご多忙のところご回答いただき本当にありがとうございましたｍｍ