Главная · Возможности · Интеграции чат-бота с CRM, helpdesk и вашим сервером
Интеграции
Интеграции чат-бота с CRM, helpdesk и вашим сервером
События диалогов из Telegram, MAX, ВКонтакте и чата на сайте уходят в вашу CRM или helpdesk, а ответ сотрудника из Омнидеска или по API приходит покупателю в тот же канал. Битрикс24 и Омнидеск подключаются напрямую, остальное — через Make, n8n, Albato или API.
На любом тарифе, включая БесплатныйШесть событий с подписью HMACОтвет из helpdesk — в канал покупателя
Что умеют интеграции ЧБТ
Шесть событий диалога наружу
«Сообщение от покупателя», «Ответ бота или оператора», «Начался диалог», «Диалог передан человеку», «Диалог закрыт» и «Новый контакт». Отметьте нужные и выберите каналы: все или только некоторые.
Битрикс24 и Омнидеск без переходников
Для них ЧБТ сам собирает запрос в их формате. В Битрикс24 появляется лид, в Омнидеске — обращение, куда дописываются следующие сообщения покупателя.
Ответ из helpdesk — в мессенджер
Сотрудник отвечает в Омнидеске или в вашей системе через API, а покупатель получает ответ в Telegram, MAX, ВКонтакте или в чате на сайте. Бот в этом диалоге замолкает.
Подпись, повторы и журнал
Событие в формате ЧБТ подписано HMAC-SHA256. Адрес не ответил — до пяти попыток: через 30 секунд, 2 минуты, 10 минут и час. «Журнал доставок» показывает код ответа вашей системы и текст ошибки.
«HTTP-запрос» прямо из сценария
Блок «Действие» отправляет на ваш адрес JSON с тегами контакта, переменными сценария — например, телефоном из блока «Сбор данных», — последним сообщением и каналом. Ответ сервера бот сохранит в переменную.
Внешнее событие запускает сценарий
Триггер «Входящий webhook» даёт сценарию адрес с секретом. Ваша система отправляет на него POST — и сценарий стартует: заводит сделку в CRM, уведомляет оператора, передаёт данные дальше.
Как подключить
-
1
Откройте «Интеграции и API»
В меню бота выберите «Интеграции и API», в карточке «Новое подключение» — поле «Система»: Битрикс24, Омнидеск, Make, n8n, Albato или «Свой сервер».
-
2
Укажите адрес и события
Вставьте «Адрес приёма событий», для Омнидеска — адрес, email сотрудника и API-ключ. Отметьте события, при нескольких каналах выберите нужные, нажмите «Подключить» и сразу сохраните секрет подписи.
-
3
Проверьте кнопкой «Тест»
ЧБТ отправит пример события, а «Журнал доставок» покажет код ответа вашей системы и текст ошибки, если она была. Секрет подписи повторно не показывается — только заменяется кнопкой «Новый секрет».
-
4
Настройте обратный путь
Для ответов из своей системы: «Токены API» → «Выдать токен». Для Омнидеска: «Адрес для ответов сотрудников» — в его кастомный канал, номер канала cch — в поле «Кастомный канал».
Какие системы подключаются и как
| Система | Как подключается | Что происходит |
|---|---|---|
| Битрикс24 | Готовое подключение: адрес входящего вебхука портала с crm.lead.add.json на конце | Каждое событие создаёт новый лид «Чат-бот: …» с именем и текстом события — без телефона и e-mail. По умолчанию включены «Диалог передан человеку» и «Новый контакт»; дубли не ищутся |
| Омнидеск | Готовое подключение: «Адрес Омнидеска», «Email сотрудника», «API-ключ» и «Кастомный канал». Сотруднику нужен доступ к этому каналу | Первое сообщение покупателя создаёт обращение, следующие дописываются в него. Передача человеку, закрытие и ответы бота приходят внутренними заметками. Ответ сотрудника уходит покупателю в его канал |
| YCLIENTS | Раздел «YCLIENTS» бота: ссылка на онлайн-запись салона (или ID филиала) и партнёрский токен из аккаунта разработчика YCLIENTS | Блок сценария «Запись в YCLIENTS» показывает услуги, мастеров и свободное время из онлайн-записи салона и создаёт запись в журнале YCLIENTS; перед визитом бот напоминает о ней в том же чате. Подробно — в справке |
| Make, n8n, Albato | Адрес входящего вебхука из вашего сценария в сервисе | Событие приходит JSON как есть, а дальше сервис создаёт сделку в amoCRM, пишет письмо или строку в таблицу |
| Свой сервер | Адрес, который принимает POST с JSON | Событие с подписью в заголовке X-Chbt-Signature: HMAC-SHA256 от метки времени X-Chbt-Timestamp и тела запроса, рекомендуемый допуск по времени — 300 секунд |
| amoCRM, RetailCRM, Юздеск, МойСклад | Напрямую не подключаются: наш JSON они не принимают | Кабинет не создаст подписку и предложит Make, n8n или Albato |
| Google Таблицы | Веб-приложение Apps Script | Есть в списке систем, но на живой таблице связку мы не проверяли: Apps Script отвечает переадресацией, а её ЧБТ считает неудачной доставкой. Пока надёжнее вести таблицу через Make или n8n |
В событии — только данные диалога: номер и статус диалога, канал, имя контакта и его ID в канале, текст сообщения до 4000 знаков. Если бот ответил карточками товаров, добавляются до 10 карточек: название, цена, валюта, ссылка, фото и наличие. Телефона, e-mail, тегов и переменных в событиях нет — их передаёт «HTTP-запрос» из сценария. Переписка из тест-чата редактора наружу не уходит.
Остальные связи настраиваются в своих разделах. Каналы — Telegram, MAX, ВКонтакте и чат на сайте — подключаются отдельно, и один сценарий отвечает во всех. Товары приходят товарным фидом, файлом или ключом API Wildberries: каталог Wildberries помечен «не проверено», пока не пройдёт первая загрузка, а остатки по ключу не читаются — подробнее на страницах каталога товаров и Wildberries. Чатов маркетплейсов нет ни у одной площадки, и на отзывы и вопросы площадок бот не отвечает. Если своей CRM нет, сценарий заводит сделку во встроенной CRM действием «Сделка в CRM», а раздел «Контакты» кнопкой «Экспорт CSV» выгружает имя, e-mail, телефон, канал и теги. Умные ссылки Мобзио подключаются в разделе «Маркетплейсы» ключом API вашего аккаунта Мобзио: кнопка товара в ответе ИИ-продавца открывает приложение площадки. Ссылки на ваш интернет-магазин не оборачиваются, первый переход по новому товару может пройти напрямую, а при любой ошибке Мобзио покупатель уходит по обычной ссылке.
Как ваша система отвечает покупателю
Публичный API — это адрес https://app.chbt.io/api/v1 и токен из «Токены API». По нему ваша система читает диалоги и историю, отвечает покупателю, закрывает диалог или передаёт его человеку. Ответ через API уходит в тот канал, из которого написал покупатель, появляется в разделе «Диалоги» как ответ оператора и не возвращается к вам событием — эха своего же сообщения не будет.
| Метод | Что делает |
|---|---|
| GET /conversations | Список диалогов с фильтром по статусу bot, ai, inbox или closed — по 50, до 200 за запрос |
| GET /conversations/:id/messages | История сообщений диалога |
| POST /conversations/:id/messages | Ответ покупателю в его канал, текст до 4000 знаков |
| POST /conversations/:id/handoff | Передать диалог человеку |
| POST /conversations/:id/close | Закрыть диалог |
| POST и GET /presence | Сообщить и проверить статус «оператор онлайн» |
- Токен передаётся заголовком Authorization: Bearer, начинается с chbt_ и показывается один раз — в ЧБТ хранится только его отпечаток.
- Лимит — 120 запросов в минуту на токен; сверх него API отвечает кодом 429 с паузой в заголовке Retry-After.
- Статус «оператор онлайн» в чате на сайте живёт от 30 до 900 секунд, по умолчанию 120, и гаснет сам, если его не продлевать. Сколько у вас операторов, посетитель не видит.
- В закрытый диалог ответ не уйдёт — сначала /handoff. Если мессенджер не принял сообщение, API вернёт 502, а сообщение останется в истории.
- Выдавать и отзывать токены могут владелец и администратор бота; оператор видит раздел в режиме «Только просмотр».
«HTTP-запрос» и «Входящий webhook» в сценарии
«HTTP-запрос» ставится в блоке «Действие» — и в режиме «Шаги», и в режиме «Холст». В момент срабатывания ЧБТ отправляет на ваш URL JSON: contact — ID контакта и его теги, vars — переменные сценария, text — последнее сообщение клиента, channelType — канал: telegram, max, vk или web. Телефон и имя попадут в vars, если в блоке «Сбор данных» заполнено поле «В переменную». Запрос всегда уходит с JSON-телом, поэтому выбирайте метод POST.
Ответ ЧБТ ждёт до 15 секунд и сохраняет в переменную целиком, до 10 КБ. Пусть ваш сервер отвечает готовой фразой: её можно показать клиенту следующим сообщением — например, статус заказа по номеру из вашей учётной системы. Куда отправлять: в Make, n8n или Albato, где один сценарий создаёт сделку в amoCRM или Битрикс24, либо на свой сервер. Пошаговый пример — в статье про лиды из бота в CRM.
Триггер «Входящий webhook» даёт адрес вида https://app.chbt.io/webhook/inbound/<бот>/<путь>. Секрет создаётся сразу и передаётся в ?token= или заголовке X-Webhook-Token — без него запрос отклоняется. В теле можно передать uid, text и name. Сценарий запускается как отдельное событие в канале чата на сайте, а не как продолжение переписки клиента в Telegram или MAX: написать конкретному клиенту этот триггер не может. Как всё-таки уведомлять клиентов — в статье про уведомления через бота.
- В тест-чате «Проверить сценарий» действие «HTTP-запрос» не выполняется.
- Повторов нет: если сервер не ответил за 15 секунд, сценарий идёт дальше без ответа.
- Своих заголовков, подписи и переменных в адресе запроса нет, а поле из JSON-ответа отдельно не достать.
- Триггеру «Входящий webhook» нужны включённый сценарий и подключённый чат на сайте. Каждый новый uid — новый контакт, и на Бесплатном он расходует один из 30 диалогов месяца.
Чего интеграции не делают
Честно о границах — чтобы вы не узнали о них после запуска.
- Не подключаются напрямую к amoCRM, RetailCRM, Юздеску и МойСкладу: наш JSON они не принимают, нужен Make, n8n, Albato или свой сервер.
- Не передают в Битрикс24 телефон и e-mail: в событиях их нет. Автоматически телефон уходит во внешнюю систему только через действие «HTTP-запрос» в сценарии.
- Не сообщают о заказах, оплатах и показах товаров: в подписках только шесть событий диалога. Об оплате через блок «Оплата» сценарий узнаёт сам — на выходе «Оплачено» можно поставить «HTTP-запрос», а на заказы магазина в боте сценарий запускает триггер «Событие магазина».
- Публичный API работает только с текстом диалогов: методов для сценариев, контактов, товаров, заказов и статистики в нём нет, вложений, телефона и e-mail покупателя он не отдаёт, а написать первым тому, кто боту не писал, не может.
- Токен выдаётся только с полными правами — читать, отвечать и менять статус смены. Токен только для чтения выпустить нельзя.
- Омнидеск получает только текст: вложение покупателя приходит строкой «[вложение]», файлы сотрудника покупателю не пересылаются.
На каких тарифах
Подписки на события, Битрикс24, Омнидеск, токены API, «HTTP-запрос» и «Входящий webhook» от тарифа не зависят. На Бесплатном действует общий лимит: один бот и 30 диалогов в месяц.
Работает вместе с
Частые вопросы
Есть ли интеграция с amoCRM и Битрикс24?
С Битрикс24 — да: событие диалога создаёт лид на вашем портале, но без телефона и e-mail. С amoCRM готовой нет, она не принимает произвольный JSON. Событие или «HTTP-запрос» отправляют данные в Make, n8n или Albato, а там создаётся сделка в amoCRM.
Как передать в CRM телефон клиента?
Через «HTTP-запрос» в сценарии. Поставьте блок «Сбор данных» с полем «В переменную», например phone, а за ним «Действие» → «HTTP-запрос» на адрес Make, n8n, Albato или вашего сервера. Телефон уйдёт в vars вместе с остальными переменными. В подписках на события телефона нет.
Может ли внешняя система написать клиенту через бота?
В уже начатый диалог — да: через API ваша система отвечает покупателю в тот канал, откуда он написал, и диалог переходит к оператору. Написать первым тому, кто боту не писал, нельзя. «Входящий webhook» сообщение конкретному клиенту тоже не отправит — он запускает сценарий как отдельное событие.
Что будет, если моя система не отвечает?
ЧБТ ждёт ответа 10 секунд и делает до пяти попыток: повторы идут через 30 секунд, 2 минуты, 10 минут и час. После 20 неудач подряд подписка выключается сама, причина видна в её карточке. «Журнал доставок» показывает последние 30 отправок с кодом ответа и текстом ошибки.
Нужен ли платный тариф для интеграций?
Нет. Подписки на события, Битрикс24, Омнидеск, токены API, «HTTP-запрос» и «Входящий webhook» работают и на Бесплатном. Ограничение Бесплатного — один бот и 30 диалогов в месяц.
Откуда бот берёт товары и цены?
Из товарного фида магазина по ссылке (YML, Google Merchant, CSV), из файла CSV, TSV или JSON или с Wildberries по API — каталог там помечен «не проверено» до первой загрузки, остатки не читаются. Каталог Ozon, Яндекс Маркета, Kaspi и Uzum загружается файлом. Товар из внешнего источника приходит черновиком — бот продаёт его после публикации.
Подключается ли Instagram или Facebook?
Нет, и это решение, а не очередь на разработку: чат-ботов для сервисов Meta (признана экстремистской организацией и запрещена в РФ) в ЧБТ не будет. Каналы продукта — Telegram, MAX, ВКонтакте и чат на сайте.
Свяжите бота со своей системой
Создайте бота, откройте «Интеграции и API» и отправьте первое событие кнопкой «Тест» — на любом тарифе, включая Бесплатный.