Instagram

Что делает этот коннектор#

Клиенты отправляют личное сообщение вашему профессиональному аккаунту Instagram. Make Agent Fast отвечает тем же обоснованным агентом, что и ваше встраивание на сайте. Это официальный Instagram Messaging API на профессиональном аккаунте, привязанном к Facebook-странице.

Вне объёма: ответы комментариев в ЛС, ответы на сторис, комментарии ленты, скрейпинг и неофициальный вход Instagram. Это не ЛС в этом коннекторе.

То же приложение Meta может также питать Messenger и WhatsApp. Instagram остаётся отдельной строкой канала, чтобы оплата, ветки входящих и привязка вебхуков оставались различимыми.

Подготовьте приложение Meta и аккаунт Instagram#

Следуйте официальному гайду по началу работы с Instagram Messaging Meta. Вам нужно:

1. Профессиональный аккаунт Instagram (Business или Creator).
2. Этот аккаунт, привязанный к Facebook-странице, которую вы администрируете.
3. Приложение Meta с продуктом Instagram / Messenger и включёнными сообщениями Instagram.
4. Токен доступа Страницы для этой Страницы и 32-символьный шестнадцатеричный секрет приложения.

Соберите:

Не вставляйте токен доступа пользователя или токен для другой Страницы. Проверка Graph отказывает, если у Страницы нет привязанного профессионального аккаунта Instagram.

На Make Agent Fast нет платформенного OAuth входа Instagram. Вы приносите учётные данные из вашего приложения Meta.

Сохраните и проверьте учётные данные#

Откройте страницу Коннекторы сайта, выберите Instagram, введите токен доступа Страницы и секрет приложения и нажмите Подключить.

Make Agent Fast вызывает Graph с appsecret_proof, требует instagram_business_account и привязывает входящие события к этому id аккаунта Instagram. Затем карточка коннектора показывает свой URL вебхука и Токен проверки.

Подключение нового канала требует Operate или Scale.

Настройте вебхук Instagram#

В том же приложении Meta:

1. Откройте настройки вебхука Instagram (или Messenger).
2. Вставьте URL вебхука и Токен проверки коннектора.
3. Завершите вызов проверки.
4. Подпишите поле Instagram messages.
5. Убедитесь, что Страница и профессиональный аккаунт Instagram связаны с приложением.
6. Убедитесь, что режим приложения разрешает вашего тестового пользователя.

Токен проверки используется только для начального вызова. События во время работы должны нести X-Hub-Signature-256, совпадающий с секретом приложения. Make Agent Fast также отклоняет события, адресованные другому аккаунту Instagram, даже если они пришли от того же приложения Meta, и игнорирует полезные нагрузки Messenger object: "page" на этом URL.

Протестируйте возможности#

Отправьте обычное ЛС с разрешённого тестового аккаунта не-администратора и подтвердите ответ плюс ветку в Диалогах. Затем протестируйте аудиозаметку, если входящий голос важен.

Текст и поддерживаемое входящее аудио обрабатываются. Ответы только текстовые. Эхо ваших собственных сообщений, упоминания в сторис, изображения и другие неподдерживаемые вложения игнорируются.

Готовность к продакшену#

Завершите разрешения Meta, App Review (instagram_manage_messages и связанные разрешения Страницы), проверку бизнеса, URL конфиденциальности и шаги публикации. Успех в режиме разработки с аккаунтом роли приложения не доказывает, что публика может писать интеграции в ЛС.

Задокументируйте владеющее приложение Meta, ID Страницы и ID аккаунта Instagram для операторов. Токен Страницы может перестать работать при изменении владельца, разрешений, связи с бизнесом или политики провайдера.

Ротация или отключение#

Сгенерируйте замещающий токен Страницы, обновите коннектор, протестируйте с разрешённого пользователя, затем аннулируйте старый токен. Обновляйте Make Agent Fast немедленно после ротации секрета приложения.

Отключение или удаление коннектора не отписывает Instagram в Meta. Удалите подписку и неиспользуемые учётные данные провайдера при окончательном выводе интеграции из эксплуатации.

Решение проблем#

Учётные данные провайдера допустимы только в аутентифицированной форме коннектора или доверенном серверном вызове API.