CRM — Bitrix24 / amoCRM / AlphaCRM

Бот сам заводит сделки в твоей CRM и двигает их по воронке. Поддержаны Bitrix24, amoCRM и AlphaCRM (для образования). Связь двусторонняя: лиды уходят в CRM, а изменения сделок возвращаются в диалог.

⏱ 10 мин · 👤 для владельца · 🟢 live

За 30 секунд:
CRM: Bitrix24 (по webhook-URL), amoCRM (домен + API-ключ), AlphaCRM (URL + email + API-ключ — для учебных центров).
DOS → CRM: бот создаёт сделки/контакты из лидов.
CRM → DOS: изменения сделок (статус, заметки) прилетают обратно в ленту диалога.
Авто-правила: при смене стадии диалога сделка двигается по воронке CRM; можно настроить доп-правила (комментарий, обновление сделки).
Ключи хранятся зашифрованными.

Что синхронизируется

Основное направление — DOS → CRM: когда появляется лид, бот создаёт в твоей CRM сделку (имя, телефон, email, сумма, воронка+стадия, кастомные поля) и/или контакт.

Обратное направление — CRM → DOS: если в CRM меняют сделку, событие прилетает в DOS через входящий вебхук и показывается в логах диалога: смена статуса сделки, обновление, удаление, добавление заметки, обновление контакта.

Авто-правила (микро-движок CRM)

Помимо простой отправки лида, есть лёгкий движок правил (хранится в настройках проекта):

Сопоставление стадий — основное. Связываешь внутренние стадии воронки (Приветствие…Завершено) со стадиями сделки в своей CRM. Меняется стадия диалога → сделка автоматически едет по воронке CRM.
Свои правила — по триггерам смена статуса лида / смена стадии / создание сделки выполнить действие: двинуть сделку, добавить комментарий, обновить сделку.

💡 Движок «не блокирует» бота: правила выполняются в фоне (fire-and-forget) и не задерживают ответ клиенту. Есть защита от дублей — одно правило на диалог не сработает дважды за 5 минут (на случай повторов).

📌 Это не старый «движок автоматизаций WHEN→IF→THEN» (он удалён). Это узкий CRM-помощник: связать стадии и пару действий со сделкой.

Как подключить

Раздел проекта → «Интеграции» → секция CRM (нужна роль редактор+).

Bitrix24

Нужен webhook-URL входящего вебхука Bitrix24. Он сам несёт в себе секрет (в пути), отдельный ключ не нужен.

Вид: https://<аккаунт>.bitrix24.ru/rest/<id>/<токен>/
Должен быть https и содержать /rest/<id>/<токен>/.

amoCRM

Нужны домен + API-ключ (Bearer-токен).

Домен: можно ввести голый поддомен (mycompany) — платформа сама допишет .amocrm.ru; принимаются .ru/.com/.kz.
Пример: mycompany → https://mycompany.amocrm.ru.

AlphaCRM (для учебных центров)

Образовательная CRM (s20.online). Нужны URL, email и API-ключ — по ним платформа получает токен доступа. Бот умеет: проверить свободные слоты занятий, записать на занятие, найти ученика по телефону/имени.

🔒 Безопасность ключей. API-ключ amoCRM/AlphaCRM хранится зашифрованным. Если ключ окажется незашифрованным (например, после ручной правки в БД), платформа в проде его отвергнет — нужно пересохранить креды в настройках. URL внешней CRM защищён от подмены адреса (anti-SSRF).

🔧 Под капотом

DOS→CRM — syncLeadToCRM (адаптеры Bitrix24/amoCRM/AlphaCRM).
CRM→DOS — входящие вебхуки парсятся и применяются к диалогам (parseCrmWebhook → applyInboundCrmEvent).
Авто-правила — project_configs.crm_automations (триггеры/действия) + сопоставление стадий project_crm_stage_mapping; дедуп 5 минут на правило+диалог.
Метаданные CRM (воронки, поля) кэшируются на проект ~10 минут.

💬 Простыми словами

Если ты уже работаешь в Bitrix24 или amoCRM, бот встроится в твой привычный процесс: каждый новый клиент из переписки сам превращается в сделку в твоей CRM — не надо вручную переносить заявки. А когда у бота меняется этап разговора (например, клиент дошёл до «закрытия»), сделка сама двигается по воронке в CRM. И наоборот — если кто-то в CRM поменял сделку, ты увидишь это прямо в переписке.

Подключение зависит от CRM: для Bitrix24 нужна ссылка-вебхук (в ней уже зашит секрет), для amoCRM — адрес и ключ, для учебной AlphaCRM — адрес, почта и ключ. Все ключи хранятся в зашифрованном виде. Если используешь учебный центр — у AlphaCRM ещё и запись на занятия с поиском ученика.

Дальше: → Роли и права
Связано: Обзор интеграций · Лиды · Стадии воронки · Логи событий
Не получилось? → Функция не вызывается / падает

Документация › Интеграции › CRM