Подключение VK

Подключив сообщество ВКонтакте, вы принимаете сообщения от подписчиков прямо в Нотифлоу. Ответы оператора уходят обратно через VK Messages API.

Шаг 1. Включите сообщения в сообществе

1. Откройте сообщество: Управление → Сообщения.
2. Включите «Сообщения сообщества».
3. В подразделе «Настройки для бота» включите «Возможности бота».

Шаг 2. Создайте ключ доступа

1. Управление → Работа с API → Ключи доступа → Создать ключ.
2. Дайте права: сообщения сообщества, фотографии, документы.
3. Скопируйте полученный ключ (длинная строка) — он понадобится на шаге 4.

Шаг 3. Настройте Callback API

1. Управление → Работа с API → Callback API → Сервер.
2. В поле «Адрес» вставьте https://cp.notiflow.ru/api/vk/callback.
3. ВКонтакте покажет «Строка, которую должен вернуть сервер». Это confirmation code — скопируйте.
4. Придумайте произвольный «Секретный ключ» (например, сгенерируйте в менеджере паролей). Не сохраняйте в ВКонтакте прямо сейчас — сначала пропишите его в Нотифлоу на шаге 4.

Шаг 4. Добавьте сообщество в Нотифлоу

1. В кабинете: Поддержка → Настройки → Каналы → Мессенджеры → VK.
2. Нажмите «Добавить сообщество».
3. Заполните:
   • Домен — привязка к сайту.
   • ID сообщества — число из URL vk.com/club12345 (здесь 12345) или vk.com/public12345.
   • Ключ доступа — из шага 2.
   • Confirmation code — из шага 3.
   • Секретный ключ — тот же, что вы ввели в шаге 3.
4. Сохраните.

Шаг 5. Подтвердите сервер

1. Вернитесь в ВКонтакте: Callback API → Сервер → Подтвердить.
2. VK отправит тестовый запрос на cp.notiflow.ru/api/vk/callback, Нотифлоу вернет confirmation code → сервер станет «Подтвержденным».
3. На вкладке «Типы событий» включите Входящее сообщение (message_new).

Шаг 6. Проверьте

Напишите в сообщество с другого аккаунта или через кнопку «Сообщение» на странице сообщества. В Нотифлоу: Поддержка → Диалоги → Все — новый диалог с каналом VK. Ответьте — сообщение придет подписчику от имени сообщества.

Диагностика

В карточке сообщества в Нотифлоу — раздел «События webhook» с кодами результата:

• processed — входящее сообщение сохранено.
• confirmation — ВК проверял адрес (нормально при подтверждении).
• rejected_bad_secret — секретный ключ в ВК и в Нотифлоу не совпадают. В кабинете нажмите «Регенерировать секрет», скопируйте, вставьте обратно в настройки Callback API.
• rejected_disabled — сообщество в Нотифлоу отключено. Включите toggle.
• ignored — тип события, который мы не обрабатываем (например, board_post_new).

Серверная диагностика:

php artisan support-chat:verify-webhooks --channel=vk

Проверяет заполненность community_id, community_token, confirmation_code, secret_key — выведет FAIL по тем, где что-то пропущено.

Типичные проблемы

• «Подтвердить» не срабатывает — чаще всего неверный confirmation code в Нотифлоу. Сверьте со строкой из ВК (copy/paste, без пробелов).
• Сообщения не приходят — на вкладке «Типы событий» в ВК не включен message_new. Включите.
• 403 от VK при ответе — ключ доступа просрочен или не имеет прав на сообщения. Создайте новый ключ и обновите в Нотифлоу.