Lalexi
РуководствоПодключения

Instagram

Как подключить профессиональный аккаунт Instagram через своё приложение Meta: Instagram app ID и Instagram app secret, токен Instagram и вебхук в кабинете Meta.

Это переписка в директе Instagram. Подключение идёт через ваше собственное приложение Meta, так же как WhatsApp Business и Facebook: приложение и аккаунт принадлежат вам, Lalexi только принимает и отправляет сообщения.

Первым написать нельзя: Meta разрешает отвечать тем, кто написал сам, в течение 24 часов после его последнего сообщения.

Что нужно подготовить

  1. Профессиональный аккаунт Instagram — Business или Creator. В личный аккаунт Meta сообщения через API не отдаёт.
  2. Приложение в Meta for Developers (developers.facebook.com), тип Business, с продуктом Instagram (API setup with Instagram login).
  3. Instagram app ID и Instagram app secret — в разделе Instagram → API setup with Instagram login. Это не App ID и App Secret со страницы App settings → Basic: у приложения с входом через Instagram две разные пары ключей, и вебхуки этого канала Meta подписывает именно Instagram-парой. Вставите вторую — подключение пройдёт как надо, а не дойдёт ни одно сообщение.
  4. На App settings → Basic укажите ссылку на политику конфиденциальности и переведите приложение в режим Live: без этого Meta не присылает сообщения.
  5. Токен Instagram: Instagram → API setup with Instagram login → Generate access tokens — добавьте аккаунт, войдите в Instagram и нажмите Generate token.

Подключение делает администратор пространства — см. Команда.

Как подключить

  1. Откройте Настройки → Источники (Settings → Inboxes) и нажмите Добавить источник (Add Inbox).
  2. Выберите Instagram и заполните форму: название (необязательно), Instagram app ID, Instagram app secret, токен доступа Instagram.
  3. Как только введён Instagram app ID, под полями появятся Callback URL и проверочный токен. Настройте вебхук в своём приложении — это шаг, который Meta разрешает делать только в кабинете:
    1. Instagram → API setup with Instagram login → Configure webhooks.
    2. Вставьте Callback URL и Verify token из формы Lalexi и нажмите Verify and save.
    3. Подпишитесь на поля messages, messaging_seen и message_reactions.
  4. Нажмите Подключить. Lalexi проверит приложение и токен и подпишет аккаунт на ваше приложение.
  5. Добавьте операторов источника.

Вебхук можно настроить и после подключения: те же значения всегда есть на вкладке «Приложение Meta» в настройках источника.

Токен и его продление

Токен Instagram живёт 60 дней. Lalexi продлевает его сам, пока он не истёк — ничего делать не нужно. Если токен всё-таки перестал работать (его отозвали или аккаунт сменил пароль), в настройках источника появится предупреждение: откройте вкладку «Приложение Meta» и вставьте новый токен в «Заменить ключи». Источник и переписка остаются.

Если что-то пошло не так

СообщениеЧто делать
Meta не приняла Instagram app secretВозьмите его в Instagram → API setup with Instagram login, а не на App settings → Basic — это разные значения.
Meta не приняла токенСгенерируйте токен заново в API setup with Instagram login.
Сообщения приходят только в профессиональный аккаунтПереключите аккаунт на Business или Creator в настройках Instagram.
Уже подключено в другом пространствеОдин аккаунт может быть только в одном пространстве Lalexi.
Подключилось, но сообщения не приходятПроверьте вебхук (шаг 3), режим Live и что в полях именно Instagram-пара, а не App ID со страницы Basic. Если пишут только люди с ролью в приложении, Meta требует проверку приложения (App Review).

Содержание