Передача заявок в CRM и внешние системы
Этот гайд для тех, кому важно не потерять ни одной заявки: бот собирает контакты и пожелания клиента, а дальше сам заводит сделку в CRM, дописывает строку в таблицу, дёргает внешний сервис и уведомляет менеджера. Разберём все блоки категории «Интеграции», которые отвечают за передачу данных.
Встроенная CRM: блок «Создать лида в CRM»
Самый простой путь — встроенная CRM botvk: воронки, канбан, AI-оценка «горячести». Блок заводит новую сделку в выбранной воронке.
Настройки:
- «Воронка» — выпадающий список воронок workspace.
- «Этап (необязательно)» — этап выбранной воронки; по умолчанию — первый этап.
- «Название сделки (необязательно)» — например, «Заявка от
{first_name}». - «Сумма (необязательно)» — число или переменная, например
{order_total}.
Лид появится на канбан-доске CRM, а на дашборде — в таблице «Свежие заявки».
amoCRM: создать сделку
Подключение — один раз в «Настройки → Интеграции», карточка «amoCRM»:
- «Домен» — например,
mycompany.amocrm.ru; - «Долгосрочный токен доступа» — создайте приватную интеграцию в amoCRM и вставьте долгосрочный токен.
Ключи задаются один раз и используются всеми ботами пространства, хранятся в зашифрованном виде.
Блок «amoCRM: создать сделку»:
- «Название сделки/лида» — заголовок, под которым сделка появится в CRM; можно вставлять переменные, например «Заявка от
{first_name}». - «Комментарий (необязательно)» — уйдёт в примечание к сделке, например «Из бота, интересует
{service}». - «Переменная с телефоном (необязательно)» — имя переменной с собранным номером (например,
phoneпосле блока «Запросить значение» с типом «Телефон»).
Bitrix24: создать лид
Подключение — в «Настройки → Интеграции», карточка «Bitrix24»: создайте «Входящий вебхук» в Bitrix24 с правом crm и вставьте его URL в поле «URL входящего вебхука».
Блок «Bitrix24: создать лид» — те же три поля, что и у amoCRM: «Название сделки/лида», «Комментарий (необязательно)», «Переменная с телефоном (необязательно)».
Google Sheets: строка в таблице
Удобно, когда CRM не нужна, а заявки хочется видеть списком.
Подключение — в «Настройки → Интеграции», карточка «Google Таблицы»: подключите Google-аккаунт (OAuth) и выберите таблицу из списка (или вставьте ссылку/ID таблицы вручную, если Drive API недоступен).
Блок «Google Sheets: строка»:
- «Лист / диапазон» — имя листа (например, «Лист1») или диапазон в нотации Google Sheets (например, «Лист1!A:E»).
- «Колонки строки» — список пар «колонка → значение» (кнопка «+ Колонка»): например, колонка «A · Имя» со значением
{first_name}, колонка «B · Телефон» со значением{phone}. Значения запишутся в строку слева направо (A, B, C…).
Каждое прохождение блока дописывает новую строку в таблицу.
Webhook и API-запрос: в чём разница
Оба блока шлют HTTP-запросы во внешние системы, но задачи у них разные.
«Webhook (HTTP-запрос)» — простая отправка данных «выстрелил и забыл», один выход:
- «URL» — HTTPS-адрес, может содержать переменные сценария в фигурных скобках.
- «Метод» — POST (по умолчанию, отправляет тело JSON) или GET (только URL с query-параметрами).
- «Тело запроса (JSON, для POST)» — значения могут быть переменными, например
{"name": "{first_name}", "phone": "{phone}"}. Если оставить пустым — отправится стандартный профиль подписчика.
«API-запрос» — полноценный запрос с ответом и ветвлением, выходы «Успех» и «Ошибка»:
- «Метод» — GET (по умолчанию) / POST / PUT / DELETE.
- «URL» — полный адрес, с подстановкой переменных.
- «Заголовки» — формат «Имя: значение», по одному в строке, например
Authorization: Bearer {token}. - «Тело запроса (JSON)» — для не-GET методов, с подстановкой переменных.
- «Сохранить ответ в переменную» — тело ответа (JSON) попадёт в переменную (например,
response), к полям обращайтесь как{response.field}в следующих блоках.
Ответ со статусом 2xx уводит поток в ветку «Успех», любой другой — в «Ошибка».
Правило выбора: нужно просто передать данные (заявка в стороннюю систему, уведомление) — берите «Webhook». Нужен ответ сервиса или обработка сбоев — берите «API-запрос».
Уведомить менеджера в VK
Блок шлёт сообщение администратору сообщества в личные сообщения VK — чтобы заявка не ждала, пока кто-то откроет CRM.
Настройки:
- «Текст уведомления» — например, «Новая заявка от
{first_name}. Телефон:{phone}». - «VK ID менеджера (необязательно)» — по умолчанию уведомление получает тот, кто подключил сообщество.
VK доставит уведомление, только если у менеджера открыт диалог с сообществом. Попросите менеджера один раз написать сообществу любое сообщение.
Типовой сценарий
Классическая связка «квиз → лид в CRM + уведомление менеджеру»:
- Триггер «Старт по команде» — команды
/start, подобрать. - «Выбор из вариантов» — «Выберите услугу:», выбор сохраняется в переменную
service(отдельный выход на каждый вариант, дальше ветки сходятся). - «Запросить значение» (тип «Текст») — уточняющий вопрос квиза, ответ в
answer. - «Запросить значение» (тип «Телефон») — номер сохраняется в
phoneс автоматической валидацией. - «Создать лида в CRM» — воронка по умолчанию, название «Заявка от
{first_name}». - «Уведомить менеджера в VK» — «Новая заявка от
{first_name}. Услуга:{service}. Телефон:{phone}». - «Google Sheets: строка» (по желанию) — дублируем заявку в таблицу: A —
{full_name}, B —{phone}, C —{service}. - «Отправить сообщение» — «Спасибо! Менеджер свяжется с вами в ближайшее время».
- «Завершить сценарий».