Как подключить профессиональный аккаунт Instagram через своё приложение Meta: Instagram app ID и Instagram app secret, токен Instagram и вебхук в кабинете Meta.
Это переписка в директе Instagram. Подключение идёт через ваше собственное приложение Meta, так же как WhatsApp Business и Facebook: приложение и аккаунт принадлежат вам, Lalexi только принимает и отправляет сообщения.
Первым написать нельзя: Meta разрешает отвечать тем, кто написал сам, в течение 24 часов после его последнего сообщения.
Что нужно подготовить
- Профессиональный аккаунт Instagram — Business или Creator. В личный аккаунт Meta сообщения через API не отдаёт.
- Приложение в Meta for Developers (developers.facebook.com), тип Business, с продуктом Instagram (API setup with Instagram login).
- Instagram app ID и Instagram app secret — в разделе Instagram → API setup with Instagram login. Это не App ID и App Secret со страницы App settings → Basic: у приложения с входом через Instagram две разные пары ключей, и вебхуки этого канала Meta подписывает именно Instagram-парой. Вставите вторую — подключение пройдёт как надо, а не дойдёт ни одно сообщение.
- На App settings → Basic укажите ссылку на политику конфиденциальности и переведите приложение в режим Live: без этого Meta не присылает сообщения.
- Токен Instagram: Instagram → API setup with Instagram login → Generate access tokens — добавьте аккаунт, войдите в Instagram и нажмите Generate token.
Подключение делает администратор пространства — см. Команда.
Как подключить
- Откройте Настройки → Источники (Settings → Inboxes) и нажмите Добавить источник (Add Inbox).
- Выберите Instagram и заполните форму: название (необязательно), Instagram app ID, Instagram app secret, токен доступа Instagram.
- Как только введён Instagram app ID, под полями появятся Callback URL и
проверочный токен. Настройте вебхук в своём приложении — это шаг,
который Meta разрешает делать только в кабинете:
- Instagram → API setup with Instagram login → Configure webhooks.
- Вставьте Callback URL и Verify token из формы Lalexi и нажмите Verify and save.
- Подпишитесь на поля
messages,messaging_seenиmessage_reactions.
- Нажмите Подключить. Lalexi проверит приложение и токен и подпишет аккаунт на ваше приложение.
- Добавьте операторов источника.
Вебхук можно настроить и после подключения: те же значения всегда есть на вкладке «Приложение 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). |
Как подключить страницу Facebook (Messenger) через своё приложение Meta: ID и секрет приложения, токен страницы, проверка и вебхук — автоматически.
Avito
Как подключить чаты Авито к Lalexi: профиль компании, проверка реквизитов, подписка нужного уровня и привязка аккаунта — входом через Авито или ключами API.