Перейти к содержанию

Руководство по настройке Meta (Instagram и Messenger)

Подключение вашего бота к Facebook Messenger и Instagram Direct Messages требует настройки приложения на портале Meta для разработчиков.

Этот процесс состоит из нескольких этапов, так как Meta требует явного разрешения и вебхуков для маршрутизации сообщений со своих платформ на ваш экземпляр FRENZY.BOT.

Предварительные требования

Перед началом убедитесь, что у вас есть: 1. Страница Facebook для вашего бизнеса. 2. Профессиональный аккаунт Instagram (бизнес или автор), связанный с этой страницей Facebook. 3. Доступ к панели управления FRENZY.BOT для получения URL вебхука.

Шаг 1: Создание приложения Meta

  1. Перейдите на Портал Meta для разработчиков и войдите в систему.
  2. Нажмите My Apps в правом верхнем углу, затем нажмите Create App.
  3. Выберите тип приложения Other и нажмите Next.
  4. Выберите Business и нажмите Next.
  5. Введите App Display Name (например, "My Business Bot") и ваш контактный email.
  6. Выберите свой Business Account (необязательно, но рекомендуется) и нажмите Create App.

Шаг 2: Добавление продуктов в приложение

В панели управления приложением: 1. Прокрутите вниз до раздела Add products to your app. 2. Найдите Messenger и нажмите Set Up. 3. В левой боковой панели нажмите Messenger → Instagram settings (если вам нужен Instagram) или оставайтесь в Messenger → settings (для Facebook Messenger).

Шаг 3: Генерация токенов доступа

Вам понадобится токен доступа к странице (Page Access Token), чтобы позволить FRENZY.BOT отправлять сообщения от вашего имени.

  1. В разделе Messenger → Settings найдите блок Access Tokens.
  2. Нажмите Add or Remove Pages и пройдите аутентификацию через свой аккаунт Facebook.
  3. Выберите страницу(ы) Facebook, которые вы хотите подключить, и предоставьте запрошенные разрешения.
  4. Как только страница будет привязана, нажмите Generate Token рядом с ней.
  5. Немедленно скопируйте этот токен и сохраните его. Вы вставите его в панель управления FRENZY.BOT.

Шаг 4: Настройка вебхука

Это указывает Meta, куда отправлять входящие сообщения.

  1. В панели управления FRENZY.BOT перейдите в Channels → Messenger (или Instagram).
  2. Найдите на этой странице ваш уникальный Webhook URL и Verify Token.
  3. Вернитесь на портал Meta для разработчиков, прокрутите вниз до раздела Webhooks (в настройках Messenger).
  4. Нажмите Add Callback URL.
  5. Вставьте Webhook URL и Verify Token из панели управления FRENZY.BOT.
  6. Нажмите Verify and Save.

Шаг 5: Подписка на события

Вы должны указать Meta, какие события отправлять на ваш вебхук.

  1. В разделе Webhooks нажмите Manage рядом с названием вашей страницы.
  2. Подпишитесь на следующие поля:
  3. messages (обязательно для текстовых сообщений)
  4. messaging_postbacks (обязательно для нажатий на кнопки/быстрых ответов)
  5. messaging_optins (опционально, для кнопок "Начать")
  6. Нажмите Save.

Шаг 6: Поиск ваших ID

Если вы настраиваете Instagram, вам понадобятся специфические ID:

  1. Instagram Account ID:
  2. Перейдите в Настройки страницы Facebook → Связанные аккаунты → Instagram.
  3. Или используйте Graph API Explorer: GET /v18.0/me?fields=instagram_business_account
  4. Recipient IGID:
  5. Это ID пользователя в Instagram, который должен получать уведомления (если Instagram используется в качестве интеграции). Для настройки канала (Channel) это обычно не требуется, если не указано иное в панели управления.

Шаг 7: Завершение в FRENZY.BOT

  1. Вернитесь в панель управления FRENZY.BOT (Channels → Messenger или Instagram).
  2. Вставьте Page Access Token, сгенерированный на шаге 3.
  3. Вставьте все необходимые ID (например, Instagram Account ID).
  4. Переключите тумблер Enable, чтобы включить канал.
  5. Нажмите Save Settings.

⚠️ Важно: Проверка приложения (Публикация)

При создании приложения Meta оно находится в режиме разработки (Development Mode).

В режиме разработки ваш бот будет отвечать только вам и другим разработчикам/тестировщикам, добавленным в приложение на портале Meta (в разделе App Roles).

Чтобы бот отвечал всем пользователям, вы должны: 1. Пройти Business Verification (подтверждение компании) в портале Meta для разработчиков. 2. Запросить расширенный доступ (Advanced Access) для определенных разрешений (обычно pages_messaging и instagram_manage_messages). 3. Предоставить видеозапись (screencast), демонстрирующую работу вашего бота. 4. После одобрения переключите тумблер приложения в верхней части экрана с Development на Live.

Примечание: процесс проверки Meta может занять несколько дней.