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

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: связываешь переменную бота (имя, телефон, город, бюджет…) с полем сделки: данные ложатся прямо в поле, а не в комментарий.
• Зеркало диалога: можно включить копирование всей переписки в ленту сделки (все сообщения или только ответы бота).
• CRM → DOS: изменения сделок (статус, заметки, удаление) прилетают обратно в ленту диалога: через готовую ссылку-вебхук, которую генерируешь в один клик.
• Сопоставление стадий: при смене стадии диалога сделка двигается по воронке CRM.
• Ключи хранятся зашифрованными.

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

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

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

Что можно настроить (в разделе «Интеграции» → CRM)

Всё ниже делается через интерфейс, роль редактор+. Появляется после того, как CRM подключена и прошла проверку связи.

1. Сопоставление стадий

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

ℹ️ Про «Неразобранное» в amoCRM. Этой стадии в списке выбора не будет, и так задумано: amoCRM разрешает попасть в неё только новой заявке, а перевести туда существующую сделку не даёт даже вручную по API. Если бы мы её предлагали, сопоставление выглядело бы настроенным, а сделка молча никуда не ехала. Выбирай любую следующую стадию воронки.

2. Заполнение полей CRM данными бота

Связываешь переменную бота (стандартные: имя, телефон, email, итог разговора, сумма; или любое поле анкеты) с полем сделки в твоей CRM. Когда бот собрал данные, они ложатся прямо в поле сделки, а не в общий комментарий. Тут же можно задать заголовок сделки по умолчанию и воронку по умолчанию для новых сделок.

⚠️ Сначала нажми «Синхронизировать» метаданные CRM: платформа подтянет список реальных полей твоей воронки, чтобы было из чего выбирать.

3. Зеркало диалога (переписка → лента сделки)

Тумблер «Зеркалировать сообщения»: вся переписка с клиентом копируется в ленту связанной сделки CRM как комментарии (👤 Клиент / 🤖 Бот / 👨‍💼 Оператор). Охват на выбор: все сообщения или только ответы бота. Включение не тянет старую историю: зеркалятся только сообщения после включения. Идёт в фоне (раз в пару минут), ответ клиенту не задерживает, дубликатов не создаёт.

4. Обратная синхронизация (CRM → DOS)

Кнопка «Сгенерировать ссылку» даёт готовый URL входящего вебхука (секрет уже вшит в ссылку). Вставляешь его в исходящий вебхук своей CRM (Bitrix24: Разработчикам → Исходящий вебхук; amoCRM: Настройки → API). После этого изменения сделок из CRM прилетают обратно в ленту диалога: смена статуса, обновление, удаление, заметка. Ссылку можно скопировать или перевыпустить (старая перестанет работать).

📌 Кроме этого под капотом есть узкий микро-движок CRM (crm_automations): фоновые действия по триггеру стадии. Это не старый «движок автоматизаций WHEN→IF→THEN» (он удалён). Основные автоматизации, доступные через интерфейс: это четыре пункта выше.

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

Раздел проекта → «Интеграции» → секция 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_settings.field_mapping (переменная→поле) → autoSyncFieldsToCrm → adapter.updateDeal (после ответа бота). Неизвестные CRM-полю ключи молча игнорируются.
• Зеркало диалога: crm_settings.mirror_messages/mirror_scope; фоновый крон crm-mirror (*/2 мин) шлёт непросинхроненные сообщения в ленту сделки (addDealComment), помечает messages.crm_synced_at (идемпотентность per-message).
• CRM→DOS: входящие вебхуки парсятся и применяются к диалогам (parseCrmWebhook → applyInboundCrmEvent). Секрет принимается заголовком x-crm-secret или query-параметром ?secret= (CRM не умеют слать кастомные заголовки), опционально HMAC.
• Авто-правила: project_configs.crm_automations (триггеры/действия) + сопоставление стадий project_crm_stage_mapping; дедуп 5 минут на правило+диалог.
• Метаданные CRM (воронки, поля) кэшируются на проект ~10 минут.

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

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

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

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