Перейти к основному содержимому
Версия: Последняя

Instagram-канал: создание и настройка

Лицензия

Данный функционал доступен только при наличии модуля Instagram.

Доступы

Для управления каналами пользователь должен находиться в группе с правами Администратор или Управление каналами.

Модуль Instagram поддерживает два сценария взаимодействия с пользователями:

  • обмен личными сообщениями через Instagram Direct;
  • обработку комментариев к публикациям профессионального Instagram-аккаунта.

После подключения канала оба сценария становятся доступны в едином интерфейсе IQChannels.

1. Предварительная подготовка​

Перед подключением Instagram-канала необходимо подготовить окружение в Meta (Facebook Developers).

1.1 Требования​

Необходимо:

  • иметь профессиональный Instagram аккаунт (Business или Creator);
  • привязать Instagram-аккаунт к Facebook Page (через Meta Business Suite);
  • иметь доступ к Meta for Developers;
  • создать приложение в Meta Developers;
  • получить:
    • App ID
    • App Secret
    • User Access Token
  • получить права:
    • instagram_manage_messages (Direct)
    • instagram_manage_comments (Комментарии)
  • настроить Webhook для объекта Instagram.

1.2 Базовый процесс авторизации (важно понимать архитектуру)​

Процесс подключения канала в системе включает следующие шаги:

  1. Создается Facebook App в Meta Developers.
  2. Получаются AppID, AppSecret, User Access Token.
  3. В IQChannels создается канал Instagram.
  4. Пользователь вводит AppID, AppSecret, Access Token.
  5. Backend:
    • создает конфигурацию канала;
    • обменивает токен на Long-lived User Access Token;
    • получает список страниц через /me/accounts;
    • определяет связанную Facebook Page;
    • извлекает Page Access Token;
    • получает instagram_business_account;
    • сохраняет идентификаторы Instagram и Facebook страниц.
  6. Система сохраняет и периодически обновляет токены.
  7. Генерируется Verify Token для Webhook.

1.3 Настройка Webhook в Meta​

После создания канала:

  • отображается Webhook URL
  • отображается Verify Token

В Meta Developers необходимо:

  1. Перейти в Webhooks
  2. Выбрать объект Instagram
  3. Указать:
    • Callback URL → из IQChannels
    • Verify Token → из IQChannels
  4. Подписаться на события:
    • messages (Instagram Direct)
    • comments (Instagram Comments)

1.4 Важное ограничение Meta​

  • Сообщения и комментарии доставляются только для подключенных Business/Creator аккаунтов
  • Для отправки сообщений действуют ограничения Meta (например, 24-hour messaging window для Direct)
  • Без подписки на Webhook события данные не будут поступать в систему

2. Создание Instagram-канала​

  1. Перейдите в нужный проект.
  2. Откройте вкладку «Каналы».
  3. Нажмите «Создать канал».
  4. Заполните форму:
    • Тип канала — Instagram
    • Название — отображаемое имя
    • На английском — уникальное системное имя
    • Описание — (необязательно)
  5. Нажмите «Создать канал».

3. Настройка Instagram-канала​

  1. Откройте созданный канал.
  2. Перейдите во вкладку «Настройки».
  3. Укажите параметры подключения:
  • App ID
  • App Secret
  • User Access Token
  • (опционально) Page / Instagram данные (если вводятся вручную)
  1. Нажмите «Сохранить».

3.1 Автоматическая обработка при сохранении​

После сохранения система:

  • проверяет токены;
  • получает список Facebook Pages;
  • определяет связанную страницу;
  • извлекает Page Access Token;
  • получает Instagram Business Account ID;
  • сохраняет идентификаторы в конфигурации канала;
  • активирует Webhook интеграцию.

4. Проверка работоспособности​

После успешного подключения:

Instagram Direct​

  • входящие сообщения автоматически поступают в IQChannels;
  • создается обращение на каждого пользователя;
  • все сообщения одного пользователя объединяются в один диалог;
  • вложения (изображения, видео, аудио, файлы) отображаются в обращении;
  • ответы оператора отправляются в Instagram Direct.

Instagram Comments​

  • комментарии к публикациям поступают в IQChannels;
  • создается обращение на пользователя;
  • ответы публикуются как ответы на комментарии;
  • в обращении отображается ссылка на публикацию Instagram.

5. Работа операторов​

5.1 Instagram Direct​

Оператор может:

  • просматривать входящие сообщения;
  • отвечать пользователям;
  • работать с вложениями;
  • видеть историю переписки;
  • отвечать на конкретные сообщения.

5.2 Instagram Comments​

Оператор может:

  • просматривать комментарии пользователей;
  • отвечать на комментарии;
  • видеть цепочку обсуждения;
  • переходить к исходной публикации;
  • вести диалог в рамках комментариев.

6. Диагностика (при проблемах)​

Если сообщения или комментарии не поступают:

Проверки в первую очередь:​

  • Instagram аккаунт должен быть Business / Creator
  • аккаунт должен быть привязан к Facebook Page
  • Webhook должен быть настроен в Meta
  • подписки должны включать:
    • messages (Direct)
    • comments (Comments)
  • токен должен быть действительным

Частые причины проблем​

1. Нет входящих сообщений​

  • не подписан Webhook messages
  • неверный Page Access Token
  • Instagram аккаунт не Business

2. Нет комментариев​

  • не подписан Webhook comments
  • отсутствует доступ instagram_manage_comments

3. Ошибки отправки ответов​

  • истек Page Access Token
  • нарушено ограничение Meta (например, 24-hour window)
  • нет прав instagram_manage_messages / instagram_manage_comments

4. Webhook не работает​

  • неверный Verify Token
  • Webhook URL недоступен извне (HTTPS обязателен)
  • не подтверждена подписка в Meta Developers

7. Технические замечания (для понимания работы системы)​

Эти детали не требуются для настройки, но объясняют поведение системы:

  • все события Instagram приходят через единый Webhook;
  • маршрутизация выполняется по Instagram Account ID;
  • Direct и Comments используют один endpoint;
  • обращения группируются:
    • Direct → по пользователю
    • Comments → по пользователю и ветке комментариев;
  • токены периодически обновляются системой автоматически.

8. Итог​

После настройки:

  • Instagram Direct и Comments работают в одном канале;
  • все обращения централизованы в IQChannels;
  • операторы работают через единый интерфейс без доступа к Meta API;
  • обмен сообщениями полностью синхронизирован с Instagram.