Чтение истории DM в Instagram: Conversations API
Conversations API в Instagram читает историю личных сообщений профессионального аккаунта на graph.instagram.com. GET /me/conversations?platform=instagram выводит список диалогов с их updated_time, GET /<CONVERSATION_ID>?fields=messages выводит сообщения диалога по ID и времени, а GET /<MESSAGE_ID>?fields=id,created_time,from,to,message возвращает одно сообщение. Подробные данные доступны для 20 последних сообщений каждого диалога.
easyCoexistence пересылает новые личные сообщения Instagram на ваш эндпоинт по мере поступления и отвечает с помощью send_social_dm в пределах окна обслуживания клиентов (24 часа) из Claude, ChatGPT или вашего кода, через официальный API Meta; инструмента для истории Conversations API у него нет.
Последние сообщения каждого диалога, по которым API возвращает подробности; более старые возвращают ошибку о том, что они удалены.
Период неактивности, после которого диалоги в папке «Запросы» больше не возвращаются.
Количество вызовов Conversations API, которые приложение может сделать в секунду для каждого профессионального аккаунта Instagram.
instagram_business_basic и instagram_business_manage_messages, с токеном от пользователя, который может управлять сообщениями аккаунта.
Как получить список диалогов аккаунта?
С помощью GET /me/conversations или /<IG_ID>/conversations и параметра platform=instagram, с токеном доступа Instagram User от пользователя, который может управлять сообщениями аккаунта. Каждая запись в массиве data соответствует одному диалогу с его 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-scoped ID этого человека, то есть IGSID, который приходит как sender.id, когда он пишет аккаунту. Ответ вернёт id диалога этого человека. Так событие вебхука превращается в его переписку без перебора всего списка.
GET https://graph.instagram.com/me/conversations
?user_id=<IGSID>
&access_token=<ACCESS_TOKEN>Как читать сообщения?
В два шага. GET /<CONVERSATION_ID>?fields=messages выводит сообщения диалога по id и created_time, это поля по умолчанию. Затем GET /<MESSAGE_ID> с fields=id,created_time,from,to,message возвращает одно сообщение: кто его отправил и кому, каждый с 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 четыре ограничения на то, что возвращается:
- Подробности сообщений: 20 последних сообщений каждого диалога; запрос более старого возвращает ошибку о том, что оно удалено.
- Запросы: диалоги в папке «Запросы» без активности 30 дней не возвращаются.
- Публикации: опубликованный пост или Reel, которым поделились, возвращается только как URL изображения или видео.
- Частота: 2 вызова в секунду для каждого профессионального аккаунта Instagram.
Что для этого нужно?
С Instagram Login нужны разрешения instagram_business_basic и instagram_business_manage_messages и токен от пользователя, который может управлять сообщениями аккаунта. Standard Access достаточно для аккаунтов, которыми вы владеете или управляете и которые добавлены в приложение; для работы с чужими аккаунтами нужен Advanced Access. Кроме того, в настройках приложения Instagram у аккаунта должна быть включена опция «Разрешить доступ к сообщениям».
Зачем хранить запись из вебхуков?
Поскольку API возвращает подробности только для 20 последних сообщений каждого диалога, полную историю нужно сохранять по мере её появления. Вебхук messages доставляет личные сообщения по мере поступления, с IGSID человека в sender.id. Сообщения, которые отправляет аккаунт, тоже приходят, только с обратными ID, поэтому можно записывать обе стороны переписки.
Как читать историю DM через easyCoexistence?
Он пересылает личные сообщения, а не читает историю. Новые личные сообщения поступают на ваш эндпоинт по мере прихода, после того как вы задали его через set_social_webhook_destination; они передаются без сохранения копии. send_social_dm отправляет ответы в пределах окна обслуживания клиентов (24 часа), из Claude, ChatGPT или вашего кода. Ни один инструмент не вызывает me/conversations, поэтому более ранние сообщения читаются в приложении Instagram или сохраняются вашей собственной системой по мере прихода.
Распространённые ошибки
- Ожидание всей переписки от API. Подробности доступны только для 20 последних сообщений, поэтому сохраняйте личные сообщения из вебхука messages по мере их поступления.
- Опрос диалогов на предмет новых личных сообщений. API допускает 2 вызова в секунду на аккаунт, тогда как вебхук messages доставляет каждое личное сообщение сразу по приходу.
- Поиск старого запроса на переписку. Диалоги в «Запросах» без активности 30 дней больше не возвращаются.
- Принятие ошибки «сообщение удалено» за удаление его собеседником. Meta так отвечает на любое сообщение старше последних 20.
От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Можно ли экспортировать всю историю личных сообщений аккаунта Instagram?
Полностью через API нельзя: он выводит список диалогов, но подробности возвращает только для 20 последних сообщений каждого. Полная запись получается, если сохранять личные сообщения из вебхука по мере их поступления.
Отмечает ли чтение сообщений через API их как прочитанные?
Нет. Meta сообщает, что сообщения, полученные через API, не отмечаются прочитанными в приложении Instagram, пока не будет отправлен ответ.
Работает ли Conversations API с Instagram Login?
Да. Руководство Meta для него написано для Instagram Login: запросы идут на graph.instagram.com с разрешениями instagram_business_*.
Как получить имя пользователя человека из диалога?
Запросите from для сообщения: он вернёт username и ID отправителя. User Profile API возвращает больше данных, например имя, по IGSID человека после того, как он написал аккаунту.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на