Bitrix24

Обновлено · 5 минут чтения · для владельца

Бот заводит сделки в вашем Bitrix24, кладёт их в нужную воронку и этап, назначает менеджера и привязывает к карточке клиента. Подключение занимает 2 минуты: создать входящий вебхук в Bitrix24 и вставить его адрес. Что бот делает в CRM и что настроить после подключения, общее для всех CRM: CRM.
За 30 секунд:
  • В Bitrix24: Приложения → Разработчикам → Другое → Входящий вебхук, права CRM и Пользователи.
  • В DOS AI: Интеграции → CRM → Bitrix24, вставить адрес вебхука, «Проверить и подключить».
  • Нужна роль администратора портала Bitrix24 и платный тариф Bitrix24 или пробный период: на бесплатном тарифе вебхук не создать.

Подключение за 2 минуты

⚠️ Нужен платный тариф Bitrix24 или пробный период. На бесплатном тарифе Bitrix24 не даёт создать вебхук. Пробный период на 15 дней включается в самом Bitrix24.
  1. В Bitrix24 откройте Приложения → Разработчикам → Другое → Входящий вебхук.
  2. В правах отметьте CRM (crm) и Пользователи (user). «Пользователи» нужны, чтобы выбрать, кому из менеджеров достаются заявки бота. Без этого права CRM подключится, но выбора ответственного не будет, и кабинет об этом предупредит.
  3. Нажмите Создать и скопируйте адрес вебхука для вызова REST API. Он выглядит так: https://mycompany.bitrix24.kz/rest/1/abcd1234efgh5678/.
  4. В DOS AI: Интеграции → CRM → Bitrix24, вставьте адрес и нажмите «Проверить и подключить».

Скопировали адрес вместе с хвостом метода (.../crm.deal.list.json): ничего страшного, платформа его отрежет.

🔒 Адрес вебхука работает как пароль: в нём зашит ключ доступа. Не публикуйте его. Утёк, удалите вебхук в Bitrix24, создайте новый и вставьте новый адрес.

Дальше выберите воронку, этап и менеджеров: что настроить после подключения.


Что появится в Bitrix24

  • Сделка, а не лид, в той воронке и на том этапе, которые вы выбрали. Режим CRM (с лидами или простой) на это не влияет.
  • Карточка контакта, привязанная к сделке. Если клиент с этим номером уже есть в Bitrix24, сделка привяжется к нему, второй карточки не будет.
  • Комментарий в ленте сделки: что хочет клиент, откуда пришёл и ссылка на переписку в DOS AI.
  • Источник «Другое» с описанием «DOS AI · Telegram» (или WhatsApp, Instagram): в отчётах Bitrix24 видно, какие заявки привёл бот. Пришёл из рекламы: в описании ещё площадка и объявление, в полях сделки метки UTM.
  • Вернулся клиент после закрытой сделки: бот заводит новую сделку на ту же карточку, старая остаётся историей. Подробнее: повторное обращение.

Обратная связь: изменения из Bitrix24 в DOS AI

Чтобы смена этапа сделки, дела и удаление сделки появлялись в ленте диалога:

  1. В DOS AI в настройках CRM нажмите «Сгенерировать ссылку» и скопируйте её.
  2. В Bitrix24: Приложения → Разработчикам → Другое → Исходящий вебхук.
  3. В поле адреса обработчика вставьте ссылку.
  4. В событиях отметьте Обновление сделки, Удаление сделки и Создание дела.
  5. Сохраните.

Bitrix24 присылает в таких событиях только номера, поэтому стадию сделки и привязку дела платформа дочитывает сама тем же входящим вебхуком.

В ленте диалога смена этапа названа этапами, как в самом Bitrix24: «Сделка #2: «Лечение» → «Консультация»», закрытие отдельной строкой «Сделка #2 закрыта: «Успешно»». Bitrix24 шлёт событие на любую правку сделки, в том числе на ту, что сделал бот: такие события в ленту не идут, в ней только то, что поменяли в самом Bitrix24.


Если не подключается

СообщениеЧто сделать
Bitrix24 не принял адрес вебхукаВебхук удалили, пересоздали или Bitrix24 его заблокировал (так бывает, если адрес попал в открытый доступ). Откройте Приложения → Разработчикам → Интеграции, у вебхука ≡ → Изменить, скопируйте адрес заново и вставьте. Вебхука в списке нет, создайте новый.
У вебхука Bitrix24 не хватает правОткройте входящий вебхук, отметьте «CRM (crm)» и «Пользователи (user)», сохраните.
Bitrix24 закрыл доступ к вебхукуВебхук работает только на платном тарифе или в пробный период. Оплатите тариф Bitrix24 или включите пробный период и нажмите «Проверить и подключить» ещё раз. Адрес вебхука остаётся прежним.
Нужен полный адрес входящего вебхукаВставлен адрес портала, а не вебхука: в адресе вебхука есть /rest/.
Портал Bitrix24 по адресу … не найденОпечатка в начале адреса (имя портала). Скопируйте адрес вебхука заново.
CRM не ответила или отвечает слишком долгоПроверьте, открывается ли Bitrix24 в браузере, и повторите через минуту.
🏢 Коробочный Bitrix24 (на своём сервере) тоже подходит, если он открывается из интернета по https://. Адрес вебхука у него такой же, с /rest/.

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