ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Instagram DM через API и 24-часовое окно

Через API Instagram профессиональный аккаунт может ответить любому, кто отправил ему личное сообщение, в стандартном окне обмена сообщениями, которое для большинства бесед длится 24 часа. Человек должен написать первым, а аккаунт должен включить «Allow access to messages» в приложении Instagram, прежде чем любое приложение сможет читать или отправлять его личные сообщения.

EasyCoexistence отвечает на DM Instagram через send_social_dm из Claude, ChatGPT или вашего кода, в пределах 24-часового окна, и пересылает новые DM на ваш эндпоинт по мере поступления.

24 hours

Стандартное окно для ответа после сообщения человека, для большинства действий.

7 days

Отдельное окно Human Agent от Meta для ответов, которые человек пишет и помечает тегом human_agent.

1,000 bytes

Максимальный объём текста одного DM через API в кодировке UTF-8.

2534022

Подкод ошибки в рамках кода 10 для сообщения, отправленного вне разрешённого окна.

30 days

Период бездействия, после которого беседа из папки «Запросы» не возвращается API.

Кому аккаунт может писать через API?

Тем, кто уже написал ему. Беседы начинаются только тогда, когда человек пишет аккаунту из ленты, из поста, по упоминанию в Stories или иным путём, и дальше приложение может отвечать ему. Человек, оставивший комментарий к посту, может также получить один приватный ответ, об этом ниже.

API не позволяет отправить первое сообщение, а групповые беседы не поддерживаются: каждая беседа ведётся между аккаунтом и одним человеком.

Как долго длится окно для сообщений?

24 часа для большинства бесед. Meta называет это стандартным окном обмена сообщениями, и действие, которое его открывает, задаёт его длительность: сообщение от человека открывает окно на 24 часа, а его следующее сообщение открывает окно снова. Если первое сообщение пришло от человека, который нажал на объявление Click-to-Direct, окно может длиться до 7 дней.

У Meta также есть отдельное окно Human Agent на 7 дней для ответов, написанных человеком и помеченных приложением с этой функцией тегом human_agent. Оно предназначено для вопросов, которые стандартное окно не покрывает. Отправка вне любого открытого окна завершается ошибкой с кодом 10, подкодом 2534022.

Что такое «Allow access to messages»?

Настройка в приложении Instagram, которая позволяет подключённым инструментам читать и отправлять личные сообщения аккаунта. Согласно руководству Meta, она находится в разделе сообщений и ответов в Stories, затем в «Управление сообщениями» и «Подключённые инструменты». Аккаунт должен её включить, прежде чем приложение сможет управлять его личными сообщениями. Пока она выключена, отправка завершается ошибкой с кодом 200, подкодом 2534041: владелец аккаунта отключил доступ к личным сообщениям Instagram.

Как работают приватные ответы на комментарии?

Профессиональный аккаунт может отправить одно сообщение человеку, который прокомментировал его пост, Reel или Story, в течение 7 дней после комментария, а под трансляцией Live только во время эфира. Сообщение попадает в личные сообщения человека, если он подписан на аккаунт, и в запросы, если нет, и содержит ссылку на пост. Продолжить переписку можно только после ответа человека, и тогда дополнительное сообщение уходит в течение 24 часов после его ответа.

Где беседы из API появляются в приложении?

В обычном входящем ящике Instagram аккаунта, с несколькими особенностями, которые стоит знать:

  • Новые беседы от подписчиков попадают в папку «Основные», а от тех, кто не подписан на аккаунт, в «Запросы».
  • Беседа, на которую ответили через приложение, переходит в папку «Общие» независимо от настроек входящих.
  • Сообщения, переданные приложению, не отмечаются прочитанными в приложении Instagram, пока не будет отправлен ответ.
  • Запросы без активности в течение 30 дней больше не возвращаются API.

С какой скоростью аккаунт может отправлять?

Meta задаёт ограничение частоты запросов для каждого профессионального аккаунта Instagram отдельно от остальных вызовов API приложения:

  • Текст, ссылки, реакции и стикеры: 100 вызовов в секунду.
  • Аудио или видео: 10 вызовов в секунду.
  • Приватные ответы на комментарии к постам и Reels: 750 вызовов в час.
  • Conversations API: 2 вызова в секунду.

Что может содержать сообщение?

Текст, ссылки, изображения, аудио, видео, PDF-файлы, стикеры, реакции, шаблоны и публикации, которые принадлежат аккаунту. Текст должен быть в UTF-8 и не превышать 1 000 байт, а это меньше символов, когда есть акценты и эмодзи. Изображения могут быть PNG или JPEG до 8 МБ, а аудио, видео и PDF-файлы до 25 МБ.

Распространённые ошибки

  • Оставить «Allow access to messages» выключенной. Отправка завершается ошибкой с кодом 200, подкодом 2534041, пока аккаунт не включит её в приложении.
  • Подсчёт символов вместо байтов. Буквы с акцентами занимают в UTF-8 два байта, а большинство эмодзи четыре, поэтому текст, прошедший проверку на 1 000 символов, всё равно может быть отклонён.
  • Отправка второго приватного ответа на тот же комментарий. Meta разрешает один, и следующее сообщение ждёт, пока человек ответит.
  • Отсчёт окна от первого сообщения беседы. Он идёт от последнего сообщения человека, поэтому каждый его ответ даёт аккаунту больше времени.
Настройка с EasyCoexistence

Автоматизации могут отвечать самостоятельно, фиксированным текстом или с помощью ИИ, а правила «комментарий в DM» отправляют приватные ответы круглосуточно. От US$ 9 за подключение в месяц, снижаясь до US$ 0,75 по мере добавления подключений, с бесплатным пробным периодом 3 дня.

Часто задаваемые вопросы

Может ли бизнес отправить первое личное сообщение в Instagram?

Не через API. Человек должен сам написать аккаунту или оставить комментарий к одному из его постов, что даёт одно приватное сообщение в течение 7 дней.

Что происходит, когда 24 часа истекают?

API отклоняет отправку, пока человек снова не напишет, что откроет новое окно. Ответы, написанные человеком, могут использовать отдельное 7-дневное окно Human Agent от Meta с тегом human_agent.

Какой может быть длина DM, отправленного через API?

До 1 000 байт текста в UTF-8 на сообщение. Акценты и эмодзи занимают больше одного байта каждый, поэтому сообщение с ними вмещает меньше 1 000 символов.

Отображаются ли сообщения, прочитанные через API, как прочитанные в приложении?

Нет. Сообщение, переданное приложению, остаётся непрочитанным во входящих Instagram, пока не будет отправлен ответ.

Читайте дальше

Модерация комментариев в Instagram через APIКак API Instagram читает комментарии, отвечает на них, скрывает и удаляет: публичные ответы, один личный ответ на комментарий в течение 7 дней и правила.События вебхука Instagram: комментарии, упоминания и личные сообщения (DM)Как комментарии, упоминания и DM из Instagram доходят до вашего эндпоинта: что содержит каждое событие, как подписываются доставки и что проверить.Ошибки Instagram API: что означают распространённые кодыЧастые ошибки Instagram API: истёкшие токены, лимиты частоты, медиа, которые Meta не может загрузить, дневной лимит публикаций, закрытые окна переписки.Какие аккаунты Instagram работают с API: бизнес, креатор или личныйAPI Instagram работает с профессиональными аккаунтами: бизнес и креатор. Какой выбрать, что меняется при переходе и как переключиться в приложении.Вебхук сообщений Instagram: тело DM, эхо и поляЧто вебхук сообщений Instagram передаёт для DM: IGSID отправителя, текст, вложения, ответы на сторис и эхо, поле за полем, и окно 24 часа.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на