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

Как позволить клиентам подключить Instagram к вашему приложению

Ваш бэкенд вызывает POST /connect-sessions у easyCoexistence с channel instagram и отправляет клиента на возвращённый url, где он входит через Instagram Login в аккаунт Business или Creator. Клиент возвращается на ваш redirect_url с channel_id, а GET /channels/{id}?credentials=1 отдаёт токен для graph.instagram.com, чтобы приложение могло публиковать, читать комментарии и отвечать на личные сообщения.

100 posts

Посты через API, которые аккаунт Instagram может опубликовать за скользящие 24 часа; карусель считается одним постом.

JPEG

Единственный формат изображения, который Meta поддерживает для публикации в Instagram через API.

24 hours

Стандартное окно для ответа на личное сообщение в Instagram для большинства действий; первым должен написать человек.

1 private reply

Сообщения, которые аккаунт может отправить комментатору через личный ответ, в течение 7 дней после комментария.

1 hour

Срок, в течение которого ссылка подключения easyCoexistence работает до истечения сессии.

Что должен сделать клиент, чтобы подключиться?

Нужно нажать одну кнопку. Ваше приложение создаёт сессию с channel, равным instagram, redirect_url и id клиента в поле external_ref, затем отправляет клиента на её url. Размещённая страница показывает ваше название и кнопку «Продолжить с Instagram», которая открывает вход Instagram в той же вкладке, поэтому всё работает и на телефонах. Клиент подтверждает доступ и попадает на ваш redirect_url с status=connected и channel_id; ваш бэкенд подтверждает это через GET /connect-sessions/{id}.

1Your appPOST /connect-sessions with channel instagram
2Hosted pageYour name and Continue with Instagram
3Instagram LoginThe professional account approves access
4Back to youredirect_url with status and channel_id

Какие аккаунты Instagram можно подключить?

Профессиональные аккаунты, Business или Creator, с которыми работает API Instagram от Meta. Аккаунт, уже подключённый через другой сервис, который использует easyCoexistence, отклоняется, и last_error сессии сообщает об этом; клиент сначала удаляет его там или входит под другим аккаунтом. Для личных сообщений в приложении Instagram также нужно включить «Разрешить доступ к сообщениям»; путь описан в руководстве по подключению Instagram.

Какой токен получает ваше приложение?

Токен пользователя Instagram для graph.instagram.com/v25.0 и account_id_on_meta, Instagram ID аккаунта, из GET /channels/{id}?credentials=1. easyCoexistence обновляет токен задолго до окончания 60 дней, а обновление выдаёт новый токен, поэтому получайте учётные данные в начале каждой задачи, а не храните одну копию.

Как приложение публикует в аккаунт?

Через POST /channels/{id}/posts. ig_type выбирает IMAGE, CAROUSEL, REELS или STORIES; если его не указать, тип определяется по медиа: несколько файлов дают карусель, одно видео даёт Reel. Карусель здесь содержит от 2 до 10 элементов, изображения должны быть в JPEG, текст до 2 200 символов, а в посте Instagram нет поля для ссылки. Без publish_at пост уходит сразу; с ним, в указанное время, до 90 дней вперёд.

A carousel on the customer's Instagram account
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ig_post_2291" \
  -d '{
    "text": "Three looks for the weekend.",
    "ig_type": "CAROUSEL",
    "media": [
      { "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
    ]
  }'

Как комментарии и личные сообщения попадают в приложение?

Сразу после того, как вы задаёте адрес назначения: PUT /channels/{id}/webhook с вашим URL возвращает секрет подписи аккаунта, и с этого момента его комментарии, упоминания и личные сообщения пересылаются по мере поступления, подписанные заголовком X-EC-Signature. Тело содержит platform, account_id, external_id и запись вебхука от Meta без изменений: changes для комментариев и упоминаний, messaging для личных сообщений.

Как приложение отвечает на комментарии и личные сообщения?

Через API Instagram от Meta на graph.instagram.com, с токеном клиента, поэтому ответ уходит от аккаунта клиента:

  • Ответ на комментарий: POST /<IG_COMMENT_ID>/replies с полем message.
  • Ответ на личное сообщение: POST /<IG_ID>/messages с recipient, равным ID человека, и текстом сообщения, в течение 24 часов после его последнего сообщения.
  • Личный ответ на комментарий: тот же эндпоинт messages с recipient, равным comment_id, один раз на комментарий, в течение 7 дней после него.
  • Скрыть или удалить комментарий: POST или DELETE на /<IG_COMMENT_ID>.

Что происходит, когда доступ клиента прекращается?

Ваш URL событий получает channel.disconnected, когда Instagram отклоняет токен или владелец отзывает доступ в настройках Instagram. Новая сессия подключения для этого клиента возвращает аккаунт. Чтобы завершить подключение со своей стороны, DELETE /channels/{id} отзывает доступ в Meta и отменяет посты, которые ещё ждут в очереди; списание прекращается в конце расчётного периода.

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

  • Отправка изображений PNG или WebP в Instagram. Meta публикует только JPEG, поэтому пост отклоняется до постановки в очередь; сначала конвертируйте изображения.
  • Поле ссылки в посте Instagram. У постов Instagram нет ссылки, поэтому запрос отклоняется; вставьте URL в текст.
  • Кнопка «Ответить» у личных сообщений старше 24 часов. Meta разрешает ответ только в окне, которое открыло последнее сообщение человека.
  • Второй личный ответ на тот же комментарий. Meta разрешает один; следующий ждёт, пока человек ответит.
Настройка с EasyCoexistence

easyCoexistence позволяет вашим клиентам подключать Instagram к приложению через один размещённый вход, после чего ваш бэкенд получает обновляемый токен, эндпоинт для постов и комментарии с личными сообщениями через вебхук; каждое подключение находится под мониторингом круглосуточно. Те же вызовы работают для WhatsApp, Facebook, TikTok, YouTube, LinkedIn и других каналов. От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений; первые 3 дня бесплатно.

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

Нужно ли мне собственное приложение Meta, чтобы подключать аккаунты Instagram клиентов?

Нет. Клиенты входят через приложение easyCoexistence, а ваш бэкенд получает токен для API Instagram от Meta через вызов credentials.

Может ли клиент подключить несколько аккаунтов Instagram?

Да, по одному на каждый вход. Создайте сессию подключения для каждого аккаунта с одинаковым external_ref, а GET /channels?external_ref= выведет все аккаунты этого клиента.

Может ли ваше приложение планировать Stories в Instagram?

Да. Задайте ig_type равным STORIES, одно изображение или видео и время publish_at, и очередь опубликует их в это время.

Сколько стоит easyCoexistence за аккаунт Instagram?

Каждый подключённый аккаунт стоит от US$ 9 до US$ 0,75 в месяц в зависимости от диапазона общего числа подключений; первые 3 дня бесплатно.

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

API соцсетей под вашим брендом: публикации, комментарии и личные сообщения в вашем SaaSПубликации, ответы на комментарии и личные сообщения в вашем SaaS: что видят клиенты, где по-прежнему упоминается easyCoexistence и какие вызовы API.Как добавить публикацию в TikTok в ваш SaaSПубликация в TikTok для вашего SaaS: подключайте TikTok клиентов, публикуйте видео и фотопосты сразу или позже одним запросом и отслеживайте каждый пост.Как добавить WhatsApp в SaaS с помощью Embedded Signup и CoexistenceДобавьте WhatsApp в SaaS: подключайте номера клиентов через Embedded Signup и Coexistence, получайте сообщения, отвечайте в окне 24 часа, отправляйте шаблоны.Как подключить аккаунт Instagram к API или ИИ-агентуКак подключить аккаунт Instagram к API или ИИ-агенту: вход через Instagram, какое разрешение что даёт, доступ к сообщениям и ссылки для клиентов.Instagram DM через API и 24-часовое окноКак работают личные сообщения Instagram через API: кому может писать аккаунт, окно 24 часа, приватные ответы и настройка «Allow access to messages».Как получать сообщения клиентов WhatsApp и комментарии соцсетей по вебхукуВебхук на каждое подключение: сообщения WhatsApp напрямую от Meta, защита секретом в URL, а комментарии и DM соцсетей подписаны X-EC-Signature.

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

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

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

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