Подключение ВКонтакте устроено как пошаговый мастер: вы вставляете один ключ доступа сообщества, платформа сама проверяет сообщество, создаёт канал и выдаёт вам два значения для VK. Вам остаётся скопировать их в настройки сообщества и нажать «Подтвердить». Доставать восьмизначный код вручную и сводить вместе три поля больше не нужно — всё ведёт мастер.
Технически связь работает через Callback API ВКонтакте: VK присылает новые сообщения от клиентов на наш адрес (webhook), а мы отвечаем боту от имени сообщества и передаём лиды в amoCRM.
Что понадобится заранее
- Сообщество ВКонтакте, в котором вы администратор (паблик или группа).
- В сообществе должны быть включены сообщения: «Управление» → «Сообщения» → «Сообщения сообщества: Включены».
- Несколько минут — весь процесс занимает 3 шага и обычно укладывается в пару минут.
Шаг 0. Создать ключ доступа в VK
Ключ доступа — это то, что позволяет нашему боту отвечать от имени сообщества. Его выдаёт сам ВКонтакте.
- Откройте сообщество → «Управление».
- Перейдите в раздел «Работа с API» → вкладка «Ключи доступа».
- Нажмите «Создать ключ» и выдайте права «Сообщения сообщества» и «Сообщения».
- Скопируйте получившийся ключ — он начинается с
vk1.a.….
[скриншот: раздел «Работа с API» → «Ключи доступа» в кабинете VK с кнопкой «Создать ключ»]
Этот ключ остаётся у вас — на нашей стороне он используется только для отправки ответов. Если позже вы отзовёте ключ в настройках сообщества, бот перестанет отвечать.
Шаг 1. Вставить ключ и проверить сообщество
- В дашборде откройте «Каналы» → «Добавить канал».
- В качестве мессенджера выберите VK, а способ подключения — бот сообщества (Bot API). После этого вместо обычной формы откроется отдельный мастер VK из трёх шагов.
- На первом шаге «Ключ доступа сообщества» вставьте ключ из Шага 0 в поле и нажмите «Проверить токен».
[скриншот: мастер VK, этап 1 — поле «Ключ доступа сообщества» и кнопка «Проверить токен»]
Платформа обратится к ВКонтакте и покажет карточку сообщества: аватар, название, короткое имя (@…) и ID. Так вы сразу убедитесь, что подключаете именно нужное сообщество. Если сообщество закрытое или частное — рядом появится соответствующая отметка.
После успешной проверки автоматически заполнятся два поля (их можно поправить):
| Поле | Что это | Можно менять |
|---|---|---|
| Отображаемое имя | Как канал будет называться в вашем списке каналов | Да |
| ID в amoCRM (source.external_id) | Технический идентификатор источника в вашем amoCRM. Только латиница, до 40 символов, уникален в рамках вашего кабинета | Да |
[скриншот: карточка сообщества с аватаром и названием + поля «Отображаемое имя» и «ID в amoCRM»]
Необязательно: секретный ключ Callback API
Под полями есть сворачиваемый блок «Опционально: секретный ключ Callback API». Это произвольная строка, которую вы придумываете сами. Она гарантирует, что входящие события действительно приходят от ВКонтакте, а не от постороннего.
- Если вы зададите секретный ключ здесь, то то же самое значение нужно будет вставить в VK на следующем шаге.
- Если оставить пустым — проверка подписи не выполняется, канал всё равно работает (защита строится на скрытом адресе сервера).
Мы рекомендуем задать секретный ключ — это лишних 10 секунд и заметно надёжнее.
Когда карточка сообщества подтверждена и поля заполнены — нажмите «Продолжить».
Шаг 2. Подключить Callback API в VK
После нажатия «Продолжить» платформа создаёт канал и получает от ВКонтакте строку подтверждения. Канал в этот момент создаётся в статусе «На паузе» — он станет активным, как только VK подтвердит адрес сервера.
На втором шаге мастера вы увидите два значения, каждое — с кнопкой «Копировать»:
| Значение в мастере | Куда вставить в VK |
|---|---|
| Адрес сервера | Поле «Адрес» в настройках Callback API |
| Строка, которую должен вернуть сервер | Поле подтверждения (появляется в VK после нажатия «Подтвердить») |
[скриншот: мастер VK, этап 2 — два поля «Адрес сервера» и «Строка...» с кнопками «Копировать»]
Теперь в кабинете ВКонтакте:
- Откройте сообщество → «Управление» → «Работа с API» → «Callback API» → «Настройки сервера».
- В поле «Адрес» вставьте Адрес сервера из мастера. Обратите внимание на указанную в подсказке версию API — выберите её же в VK.
- В поле для строки подтверждения вставьте «Строку, которую должен вернуть сервер» из мастера.
- Если на Шаге 1 вы задавали секретный ключ — впишите ровно то же значение в поле «Секретный ключ» в VK.
- Нажмите «Подтвердить» (и сохраните настройки сервера).
[скриншот: настройки Callback API в кабинете VK — поля «Адрес», строка подтверждения, «Секретный ключ»]
Важно: включить типы событий
Чтобы сообщения клиентов доходили до бота, в VK на вкладке «Типы событий» включите как минимум «Сообщения сообщества» → «Входящее сообщение». Без этого ВКонтакте подтвердит адрес, но сами сообщения присылать не будет.
[скриншот: вкладка «Типы событий» в Callback API с включённым «Входящее сообщение»]
Шаг 3. Подтверждение и активация
Вернитесь в мастер и нажмите «Проверить». Платформа начнёт ждать подтверждения от ВКонтакте — обычно оно приходит за 1–3 секунды после того, как вы сохранили настройки в VK. Мастер проверяет статус автоматически в течение примерно полутора минут.
Как только VK подтвердит адрес сервера, канал автоматически переходит из статуса «На паузе» в «Активен», и вы увидите экран «Канал подключён» с кнопками «К списку каналов» и «Открыть канал».
[скриншот: финальный экран мастера «Канал подключён» с зелёной галочкой]
Если что-то пошло не так
- «ВКонтакте отклонил токен» — ключ скопирован не полностью, отозван в настройках сообщества, или у него нет прав «Сообщения сообщества» и «Сообщения». Создайте ключ заново на Шаге 0.
- «Канал с таким ID в amoCRM уже подключён» — значение в поле «ID в amoCRM» уже занято другим каналом. Поменяйте его на уникальное (например, добавьте суффикс) или отключите старый канал.
- «ВКонтакте так и не прислал подтверждение за 90 секунд» — чаще всего адрес сервера или строка подтверждения вставлены в VK не в те поля, либо в VK не нажата кнопка «Подтвердить»/«Сохранить». Перепроверьте оба значения в настройках Callback API и снова нажмите «Проверить ещё раз» в мастере.
- VK пишет «сервер не отвечает корректно» — обычно это значит, что строка подтверждения в VK не совпадает с той, что выдал мастер. Скопируйте её заново кнопкой «Копировать».
- Сообщения не приходят, хотя канал активен — проверьте, что в VK на вкладке «Типы событий» включено «Входящее сообщение».
- Вы настроили секретный ключ, но VK не подтверждает адрес — значит секретный ключ не вставлен (или вставлен с опечаткой) в поле «Секретный ключ» в VK. Канал останется на паузе, пока значения не совпадут.
Полезно знать
- Можно прерваться и вернуться. Если вы закрыли вкладку после Шага 2, канал не удаляется — он остаётся «На паузе». Открыть его и продолжить можно из списка каналов (ссылка «Закончить позже» ведёт прямо на страницу канала). Адрес сервера и строка подтверждения привязаны к этому каналу — пересоздавать его не нужно.
- Один адрес — одно сообщество. Не указывайте один и тот же адрес сервера для двух разных сообществ: события для «чужой» группы платформа молча отклонит.
- Ваш ключ остаётся вашим. Платформа не хранит лишнего и использует ключ только для отправки ответов от имени сообщества.