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

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 を届くとすぐにエンドポイントへ転送します。

20

API が詳細を返すのは、会話ごとの最新メッセージのみです。それより古いメッセージには、削除されたことを示すエラーが返されます。

30 days

「Requests」フォルダ内の会話は、一定期間非アクティブになると返されなくなります。

2/sec

Conversations API の呼び出しは、Instagram プロフェッショナルアカウントごとに 1 秒あたりの上限があります。

2 permissions

instagram_business_basic と instagram_business_manage_messages の権限が必要です。トークンは、アカウントのメッセージを管理できる人のものを使います。

アカウントの会話一覧は、どう取得しますか?

GET /me/conversations、または /<IG_ID>/conversations に platform=instagram を付けて呼び出します。認証には、アカウントのメッセージを管理できる人の Instagram User アクセストークンを使います。data 配列の各項目が 1 つの会話で、id と updated_time を持ちます。

Listing conversations
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 イベントをスレッドに結びつけられます。

One person's conversation
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 を含みます。本文も含まれます。

A conversation's messages, then one message
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 件より古いメッセージすべてに対して、この応答を返します。
EasyCoexistence で実現する

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 監視

確認日