Интеграция с Bitrix24
Агент создаёт лиды, сделки, контакты и дела в Bitrix24 во время разговора.
У Bitrix24 два способа подключения — выбирайте по ситуации. Подробный разбор с картинками — в статье Как подключить Bitrix24.
Bitrix24 разрешает работу с внешними сервисами не на всех тарифах: в облаке создание входящего вебхука требует подписки «Битрикс24 Маркетплейс», в коробочной версии — нет. Если пункта «Входящий вебхук» в портале нет, дело в подписке, а не в ошибке настройки.
Способ 1: входящий вебхук
Быстрый путь, занимает пару минут.
В Bitrix24:
- «Приложения» → «Разработчикам» → «Другое» → «Входящий вебхук».
- Выдайте права на работу с CRM.
- Скопируйте полученный адрес — он выглядит как
https://ваш-портал.bitrix24.ru/rest/1/xxxxxxxx/.
В кабинете Vobot:
«Интеграции» → Bitrix24 → «Подключить» → «Быстрое: вебхук» → вставьте адрес.
Подключение проверяется сразу: если адрес неверный или прав не хватает, вы увидите это на месте, а не потом на звонках.
Вебхук создаётся от имени конкретного сотрудника и работает с его правами. Если этот сотрудник уволится и его учётную запись отключат, интеграция перестанет работать. Создавайте вебхук от учётной записи администратора или технической учётки.
Способ 2: через приложение
Подключение по стандартной авторизации, без копирования адресов: приложение ставится из Битрикс24.Маркета внутри портала, после установки портал сам приводит вас в кабинет для привязки к компании.
Второй вход в тот же способ — из кабинета: «Интеграции» → Bitrix24 →
«Подключить» → «Через приложение» → укажите адрес портала
(mycompany.bitrix24.ru) → подтвердите доступ в открывшемся окне. Адрес нужен
до перехода: страница подтверждения у Bitrix24 своя для каждого портала.
Если в окне подключения этого способа нет, значит на вашей среде он пока недоступен — подключайтесь вебхуком.
Какой способ выбрать
| Вебхук | Приложение | |
|---|---|---|
| Скорость настройки | быстрее | чуть дольше |
| Привязка к сотруднику | да — работает с его правами | нет |
| Несколько порталов | неудобно | штатно |
| Обновление доступа | вручную при смене | автоматически |
Для одного портала и постоянной технической учётки достаточно вебхука. Если порталов несколько или вы не хотите зависеть от конкретного сотрудника — приложение.
Что создаёт агент
| Действие | Результат |
|---|---|
| Создать сделку | сделка или лид — зависит от настройки |
| Создать контакт | карточка клиента |
| Поставить задачу | дело ответственному |
В настройках подключения выбирается, что именно создавать: лид, сделку или контакт. Bitrix24 позволяет работать и с лидами, и без них — выберите то, что соответствует вашему процессу.
Если в компании принят классический путь «лид → квалификация → сделка», пусть агент создаёт лиды. Если лиды отключены — сделки.
Настройка полей
Как и в amoCRM: поля карточки связываются с переменными сценария в ноде «Действие CRM». Доступны и стандартные поля, и пользовательские поля вашего портала.
Подробнее — Нода «Действие CRM».
Проверка
Тест-звонок до создания карточки, затем Bitrix24:
- карточка появилась в нужном разделе;
- телефон и имя заполнены;
- ответственный назначен;
- повторный звонок с того же номера не создал дубль контакта.
Частые проблемы
«Недостаточно прав». У вебхука не выданы права на CRM. Пересоздайте вебхук, отметив нужные разрешения.
Интеграция перестала работать. Если подключались вебхуком — проверьте, активен ли сотрудник, от имени которого он создан.
Карточки создаются не там. Проверьте настройку типа сущности в подключении: лид, сделка или контакт.
Телефон не подставляется. Bitrix24 хранит телефоны в отдельной структуре с типом (рабочий, мобильный). Проверьте, что в ноде выбрано именно поле телефона, а не текстовое поле.