Instagram DM 履歴の読み取り:Conversations API
Instagram の Conversations API は、graph.instagram.com でプロフェッショナルアカウントの DM 履歴を読み取ります。GET /me/conversations?platform=instagram で、各会話と updated_time を一覧できます。GET /<CONVERSATION_ID>?fields=messages では、ID と時刻から会話のメッセージを一覧します。GET /<MESSAGE_ID>?fields=id,created_time,from,to,message は、1 件のメッセージを返します。詳細を取得できるのは、各会話の最新 20 件のメッセージです。
easyCoexistence は、新しい Instagram DM を届くとすぐにエンドポイントへ転送します。
API が詳細を返すのは、会話ごとの最新メッセージのみです。それより古いメッセージには、削除されたことを示すエラーが返されます。
「Requests」フォルダ内の会話は、一定期間非アクティブになると返されなくなります。
Conversations API の呼び出しは、Instagram プロフェッショナルアカウントごとに 1 秒あたりの上限があります。
instagram_business_basic と instagram_business_manage_messages の権限が必要です。トークンは、アカウントのメッセージを管理できる人のものを使います。
アカウントの会話一覧は、どう取得しますか?
GET /me/conversations、または /<IG_ID>/conversations に platform=instagram を付けて呼び出します。認証には、アカウントのメッセージを管理できる人の Instagram User アクセストークンを使います。data 配列の各項目が 1 つの会話で、id と updated_time を持ちます。
GET https://graph.instagram.com/me/conversations
?platform=instagram
&access_token=<ACCESS_TOKEN>
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
]
}特定の人との会話は、どう見つけますか?
user_id に、相手の Instagram スコープ ID を指定します。これは、相手がアカウントにメッセージを送ったときに sender.id として届く IGSID です。レスポンスには、その会話の id が返されます。全件をページングせずに、Webhook イベントをスレッドに結びつけられます。
GET https://graph.instagram.com/me/conversations
?user_id=<IGSID>
&access_token=<ACCESS_TOKEN>メッセージは、どう読み取りますか?
2 段階で行います。GET /<CONVERSATION_ID>?fields=messages で、会話のメッセージを id と created_time で一覧します。これがデフォルトのフィールドです。次に、fields=id,created_time,from,to,message を付けて GET /<MESSAGE_ID> を呼び出すと、1 件のメッセージが返ります。送信者と宛先は、それぞれ username と ID を含みます。本文も含まれます。
GET https://graph.instagram.com/<CONVERSATION_ID>
?fields=messages
&access_token=<ACCESS_TOKEN>
GET https://graph.instagram.com/<MESSAGE_ID>
?fields=id,created_time,from,to,message
&access_token=<ACCESS_TOKEN>どこまで過去に遡って読めますか?
Meta のガイドと概要では、返される内容に次の 4 つの制限があります:
- メッセージの詳細:各会話の最新 20 件のメッセージです。それより古いものを要求すると、削除されたことを示すエラーが返されます。
- リクエスト:「Requests」フォルダ内で 30 日間アクティビティがない会話は、返されません。
- 共有:共有された投稿やリールは、画像または動画の URL としてのみ返されます。
- レート:Instagram プロフェッショナルアカウントごとに 1 秒あたり 2 回までです。
必要なものは何ですか?
Instagram Login を使う場合は、instagram_business_basic と instagram_business_manage_messages の権限と、アカウントのメッセージを管理できる人のトークンが必要です。自分が所有または管理し、アプリに追加したアカウントには Standard Access で十分です。他のアカウントにサービスを提供するには、Advanced Access が必要です。また、アカウントの Instagram アプリ設定で「Allow access to messages」を有効にしておく必要があります。
なぜ Webhook から記録を残すのですか?
API は各会話の最新 20 件のメッセージの詳細しか返さないため、完全な履歴は届いたときに保存しておく必要があります。messages Webhook は、DM が届くとその都度配信します。その際、相手の IGSID が sender.id に入ります。アカウントが送信したメッセージも届きます。送信元と宛先の ID が逆向きになるため、会話の両側を記録できます。
easyCoexistence 経由で DM 履歴を読むには?
DM の履歴を読み取るのではなく、DM を転送します。set_social_webhook_destination でエンドポイントを設定すると、新しい DM は届くとすぐにそのエンドポイントへ転送されます。コピーは保持されません。send_social_dm で、24 時間のウィンドウ内に返信できます。Claude、ChatGPT、または独自のコードから利用できます。me/conversations を呼び出すツールはないため、過去のメッセージは Instagram アプリで読むか、届いた時点で独自のシステムに保存しておきます。
よくある間違い
- API からスレッド全体を取得できると想定すること。詳細は最新 20 件のメッセージで止まるため、messages Webhook から届いた DM を都度保存してください。
- 新しい DM を求めて会話をポーリングすること。API はアカウントごとに 1 秒あたり 2 回までですが、messages Webhook は DM が届くたびに配信します。
- 古いメッセージリクエストを探すこと。「Requests」内で 30 日間アクティビティがない会話は、もう返されません。
- 削除済みエラーを、相手が削除したと解釈すること。Meta は、最新 20 件より古いメッセージすべてに対して、この応答を返します。
24 時間のウィンドウ内では send_social_dm で返信できます。Claude、ChatGPT、または独自のコードから、Meta の公式 API を使って利用できます。Conversations API の履歴を扱うツールはありません。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
Instagram アカウントの DM 履歴を、すべてエクスポートできますか?
API では全件は取得できません。会話の一覧は取得できますが、詳細は各会話の最新 20 件のメッセージしか返されません。完全な記録は、Webhook が配信した DM を保存していくことで得られます。
API でメッセージを読むと、既読になりますか?
いいえ。Meta によると、API 経由で配信されたメッセージは、返信を送るまで Instagram アプリ上で既読になりません。
Conversations API は Instagram Login で使えますか?
はい。Meta のガイドは Instagram Login 向けに書かれており、graph.instagram.com への呼び出しと instagram_business_* の権限を使います。
会話から相手のユーザー名を取得するにはどうすればよいですか?
メッセージに対して from フィールドを要求すると、送信者のユーザー名と ID が返されます。相手がアカウントにメッセージを送った後は、User Profile API を使って IGSID から名前などをさらに取得できます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日