Интеграция с сообществом ВКонтакте
❗️ Важные правила работы с ВКонтакте, чтобы избежать блокировок
Перед подключением интеграции рекомендуем ознакомиться с правилами платформы и соблюдать базовые требования безопасности.
- Работайте только с пользователями, которые:
- сами написали в сообщения сообщества,
- дали согласие на получение рассылок.
- Не используйте массовую отправку одинаковых сообщений вручную. ВКонтакте может расценить это как спам.
- Не отправляйте:
- стороннюю рекламу (чужие проекты, Telegram, YouTube и т.д.),
- запрещенный контент (алкоголь и т.п.),
- ссылки на подозрительные или фишинговые сайты.
- Обязательно:
- соблюдайте разумную частоту сообщений,
- отправляйте только релевантный контент по теме сообщества,
- не злоупотребляйте ссылками в каждом сообщении.
- Не рекомендуется:
- резко запускать массовые рассылки с нового сообщества,
- использовать накрутки подписчиков,
- работать с одного IP для множества аккаунтов.
ВКонтакте реагирует на жалобы пользователей. Если клиенты массово отмечают сообщения как спам — возможна блокировка рассылок или ограничение сообщества.
⚙️ Настройка интеграции во ВКонтакте
Интеграцию должен настраивать администратор сообщества.
Шаг 1. Включите сообщения сообщества
- Перейдите в Управление сообществом.
- Откройте раздел Сообщения.
- Включите сообщения для сообщества.
Шаг 2. Перейдите в раздел «Дополнительно» - «Работа с API»
- В Управлении сообществом откройте раздел Работа с API.
- Перейдите во вкладку Ключи доступа.
Шаг 3. Создайте ключ доступа
- Нажмите Создать ключ.
- Отметьте права:
- доступ к сообщениям сообщества,
- доступ к истории сообщений,
- доступ к фотографиям,
- доступ к документам.
- Подтвердите создание ключа.
- Сохраните полученный токен — он понадобится в Mobifitness для поля.
Шаг 4. Настройте Callback API
- В разделе Работа с API перейдите во вкладку Callback API.
- Укажите версию API 5.199 (или актуальную, если изменена в документации VK).
- Пока что не трогайте поле «Адрес». Его вы добавите после того, как он будет сформирован в Mobifitness после сохранения настроек.
- Скопируйте:
- group_id,
- строку подтверждения.
- Укажите любой секретный ключ.
Эти параметры нужно будет вставить в Mobifitness.
🔧 Настройка интеграции в Mobifitness
Шаг 1. Перейдите в раздел Настройки → Интеграции → ВКонтакте
Шаг 2. Создайте новый канал
- Нажмите Добавить канал.
- Укажите:
- Название канала (например, «Сообщество ВК»),
- Токен (ключ доступа из ВКонтакте),
- group_id,
- Строку подтверждения,
- Секретный ключ (который вы указали самостоятельно).
- Сохраните настройки.
После сохранения система сформирует Callback API адрес. Скопируйте его.
Шаг 3. Вернитесь во ВКонтакте
- В разделе Callback API вставьте скопированный на предыдущем шаге Callback API адрес.
- Нажмите Подтвердить.
Если ВКонтакте сообщает, что сервер успешно подтвержден — интеграция установлена корректно.
Статус канала в Mobifitness должен отображаться как активный.
💬 Работа с сообщениями ВКонтакте в Mobifitness
Все входящие сообщения из сообщества автоматически создают диалог в CRM.
- Если номер телефона пользователя не передается ВКонтакте:
- диалог создается как неидентифицированный;,
- сотрудник может вручную привязать чат к карточке клиента,
- либо создать новую карточку из чата.
- В чате доступны:
- текстовые сообщения,
- изображения,
- файлы,
- история переписки.
- Если клиент ранее уже писал в сообщество, история диалога подгружается.
- При работе с рассылками учитывайте ограничения ВКонтакте:
- ограничение по количеству сообщений,
- ограничение по базе подписчиков,
- необходимость согласия на рассылку.