Home · Features · Интеграции чат-бота с CRM, helpdesk и вашим сервером
Integrations
Интеграции чат-бота с CRM, helpdesk и вашим сервером
События диалогов из Telegram, MAX, ВКонтакте и чата на сайте уходят в вашу CRM или helpdesk, а ответ сотрудника из Омнидеска или по API приходит покупателю в тот же канал. Битрикс24 и Омнидеск подключаются напрямую, остальное — через Make, n8n, Albato или API.
On any plan, including FreeШесть событий с подписью HMACОтвет из helpdesk — в канал покупателя
Что умеют интеграции ЧБТ
Шесть событий диалога наружу
«Сообщение от покупателя», «Ответ бота или оператора», «Начался диалог», «Диалог передан человеку», «Диалог закрыт» и «Новый контакт». Отметьте нужные и выберите каналы: все или только некоторые.
Битрикс24 и Омнидеск без переходников
Для них ЧБТ сам собирает запрос в их формате. В Битрикс24 появляется лид, в Омнидеске — обращение, куда дописываются следующие сообщения покупателя.
Ответ из helpdesk — в мессенджер
Сотрудник отвечает в Омнидеске или в вашей системе через API, а покупатель получает ответ в Telegram, MAX, ВКонтакте или в чате на сайте. Бот в этом диалоге замолкает.
Подпись, повторы и журнал
Событие в формате ЧБТ подписано HMAC-SHA256. Адрес не ответил — до пяти попыток: через 30 секунд, 2 минуты, 10 минут и час. «Журнал доставок» показывает код ответа вашей системы и текст ошибки.
«HTTP-запрос» прямо из сценария
Блок «Действие» отправляет на ваш адрес JSON с тегами контакта, переменными сценария — например, телефоном из блока «Сбор данных», — последним сообщением и каналом. Ответ сервера бот сохранит в переменную.
Внешнее событие запускает сценарий
Триггер «Входящий webhook» даёт сценарию адрес с секретом. Ваша система отправляет на него POST — и сценарий стартует: заводит сделку в CRM, уведомляет оператора, передаёт данные дальше.
How to connect
-
1
Откройте «Интеграции и API»
В меню бота выберите «Интеграции и API», в карточке «Новое подключение» — поле «Система»: Битрикс24, Омнидеск, Make, n8n, Albato или «Свой сервер».
-
2
Укажите адрес и события
Вставьте «Адрес приёма событий», для Омнидеска — адрес, email сотрудника и API-ключ. Отметьте события, при нескольких каналах выберите нужные, нажмите «Подключить» и сразу сохраните секрет подписи.
-
3
Проверьте кнопкой «Тест»
ЧБТ отправит пример события, а «Журнал доставок» покажет код ответа вашей системы и текст ошибки, если она была. Секрет подписи повторно не показывается — только заменяется кнопкой «Новый секрет».
-
4
Настройте обратный путь
Для ответов из своей системы: «Токены API» → «Выдать токен». Для Омнидеска: «Адрес для ответов сотрудников» — в его кастомный канал, номер канала cch — в поле «Кастомный канал».
Какие системы подключаются и как
| System | How it connects | What happens |
|---|---|---|
| Bitrix24 | Built-in connection: the portal’s incoming webhook URL ending in crm.lead.add.json | Each event creates a new lead “Chatbot: …” with the name and event text, without phone or email. “Conversation handed to a human” and “New contact” are enabled by default; duplicates are not checked |
| Omnidesk | Built-in connection: “Omnidesk address”, “Employee email”, “API key” and “Custom channel”. The employee needs access to this channel | The customer’s first message creates a ticket, and later ones are added to it. Handoffs to a human, closures and bot replies arrive as internal notes. The employee’s reply goes to the customer in their channel |
| YCLIENTS | The bot’s “YCLIENTS” section: the salon’s online booking link (or branch ID) and a partner token from the YCLIENTS developer account | The “YCLIENTS booking” flow block shows services, staff members and available times from the salon’s online booking and creates a booking in the YCLIENTS schedule; before the visit, the bot sends a reminder in the same chat. Details are in the help article |
| Make, n8n, Albato | The incoming webhook URL from your scenario in the service | The event arrives as JSON, and the service then creates a deal in amoCRM, sends an email or adds a row to a spreadsheet |
| Your own server | A URL that accepts POST with JSON | The event is signed in the X-Chbt-Signature header: HMAC-SHA256 of the X-Chbt-Timestamp and the request body; the recommended time tolerance is 300 seconds |
| amoCRM, RetailCRM, Usedesk, MoySklad | Not connected directly: they do not accept our JSON | The dashboard will not create the subscription and will suggest Make, n8n or Albato |
| Google Sheets | Apps Script web app | Listed among the systems, but we have not tested it with a live spreadsheet: Apps Script responds with a redirect, which CHBT treats as a failed delivery. For now, it is more reliable to keep the spreadsheet via Make or n8n |
An event contains only conversation data: the conversation number and status, the channel, the contact’s name and channel ID, and the message text up to 4,000 characters. If the bot replied with product cards, up to 10 cards are added: name, price, currency, link, photo and availability. Events do not include phone, email, tags or variables; send those with an “HTTP request” from the flow. Chats from the editor’s test chat are not sent out.
Other connections are set up in their own sections. Channels — Telegram, MAX, VK and website chat — are connected separately, and one flow responds in all of them. Products come from a product feed, a file or a Wildberries API key: the Wildberries catalog is marked “not verified” until the first import succeeds, and stock levels are not read via the key. Learn more on the product catalog and Wildberries pages. No marketplace offers chats, and the bot does not reply to marketplace reviews or questions. If you have no CRM of your own, the flow creates a deal in the built-in CRM with the “CRM deal” action, and the “Contacts” section exports name, email, phone, channel and tags with the “CSV export” button. Mobzio smart links are connected in the “Marketplaces” section with your Mobzio account API key: the product button in a reply from the AI sales assistant opens the marketplace app. Links to your online store are not wrapped, the first click on a new product may go directly, and if Mobzio returns any error, the customer follows the regular link.
Как ваша система отвечает покупателю
Публичный 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, либо на свой сервер. Пошаговый пример — в статье about leads from a bot in CRM.
Триггер «Входящий webhook» даёт адрес вида https://app.chbt.io/webhook/inbound/<бот>/<путь>. Секрет создаётся сразу и передаётся в ?token= или заголовке X-Webhook-Token — без него запрос отклоняется. В теле можно передать uid, text и name. Сценарий запускается как отдельное событие в канале чата на сайте, а не как продолжение переписки клиента в Telegram или MAX: написать конкретному клиенту этот триггер не может. Как всё-таки уведомлять клиентов — в статье про уведомления через бота.
- В тест-чате «Проверить сценарий» действие «HTTP-запрос» не выполняется.
- Повторов нет: если сервер не ответил за 15 секунд, сценарий идёт дальше без ответа.
- Своих заголовков, подписи и переменных в адресе запроса нет, а поле из JSON-ответа отдельно не достать.
- Триггеру «Входящий webhook» нужны включённый сценарий и подключённый чат на сайте. Каждый новый uid — новый контакт, и на Бесплатном он расходует один из 30 диалогов месяца.
Чего интеграции не делают
The limits are clear before you launch.
- Не подключаются напрямую к amoCRM, RetailCRM, Юздеску и МойСкладу: наш JSON они не принимают, нужен Make, n8n, Albato или свой сервер.
- Не передают в Битрикс24 телефон и e-mail: в событиях их нет. Автоматически телефон уходит во внешнюю систему только через действие «HTTP-запрос» в сценарии.
- Do not report orders, payments or product views: subscriptions cover only six conversation events. The flow learns about a payment made through the “Payment” block by itself — you can put an “HTTP request” on the “Paid” output, and for orders in the shop in your bot a flow is started by the “Shop event” trigger.
- Публичный API работает только с текстом диалогов: методов для сценариев, контактов, товаров, заказов и статистики в нём нет, вложений, телефона и e-mail покупателя он не отдаёт, а написать первым тому, кто боту не писал, не может.
- Токен выдаётся только с полными правами — читать, отвечать и менять статус смены. Токен только для чтения выпустить нельзя.
- Омнидеск получает только текст: вложение покупателя приходит строкой «[вложение]», файлы сотрудника покупателю не пересылаются.
Available plans
Подписки на события, Битрикс24, Омнидеск, токены API, «HTTP-запрос» и «Входящий webhook» от тарифа не зависят. На Бесплатном действует общий лимит: один бот и 30 диалогов в месяц.
Works with
FAQ
Есть ли интеграция с 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» и отправьте первое событие кнопкой «Тест» — на любом тарифе, включая Бесплатный.