Интеграции и API — для разработчиков

Шаблоны связки с Битрикс24 и встройка в сайт или внешнюю CRM.

Шаблоны интеграций с Битрикс24

Готовые сценарии связки Тат-Чат с вашими процессами в Битрикс24.

Привязка диалога к сделке — нативно, через конструктор

В сценарии бота (Telegram / MAX / ВКонтакте) добавьте шаг «Создать сделку». Бот в нужный момент диалога создаёт сделку в Битрикс24 и автоматически привязывает к ней переписку — оператор сразу видит сделку, диалог маршрутизируется на ответственного. Внешние сервисы не нужны.

1 Откройте «🧩 сценарий» у канала-бота.

2 В действии выберите «Создать сделку» (новая сделка) или «Привязать к сделке (по ID)» — если ID уже есть в переменной (например, {gotdeal}).

3 Готово — с этого момента диалог связан со сделкой: подтягивается телефон контакта, маршрутизация на ответственного.

«Привязать к сделке (по ID)» — нативный аналог Salebot gotdeal: берёт ID существующей сделки из переменной сценария и связывает диалог. Внешние сервисы не нужны.

Привязка к сделке через Salebot (переменная gotdeal)

Если вы работаете через Salebot: бот кладёт ID сделки Битрикс в переменную клиента gotdeal — Тат-Чат читает её, подтягивает телефон контакта сделки и привязывает диалог. Требуется указанный API-ключ Salebot в разделе «Подключение Salebot».

Автосоздание сделок (autodeal)

Правило «первое обращение из канала → создать сделку автоматически». Включается кнопкой «⚙️ автосделки» у канала. Доступно на всех тарифах.

Учёт источника — кампании и deep-ссылки

Создайте кампанию с кодовым словом или ссылкой (для рекламы). Клиент переходит/пишет кодовое слово — диалог помечается кампанией, в дашборде видно лиды и сделки по каждому источнику.

Маршрутизация по отделам

Привяжите каналы к отделам Битрикс24 (раздел «Роли доступа») — диалоги пойдут нужной команде, а операторы видят только свои.

Исходящее первое сообщение

Через личный Telegram-аккаунт — «Написать первым». Используйте точечно, чтобы не поймать блокировку за массовую рассылку.

ID клиента в поля Битрикса (омниканальный матчинг)

Тат-Чат может записывать идентификатор клиента из каждого канала (Telegram, MAX, ВКонтакте, Avito и др.) в поле контакта Битрикс24 — вы сами выбираете, какой id в какое поле. Так все id клиента видны прямо в его карточке, а дубли можно искать не только по телефону, но и по id (полезно для Avito, где телефона обычно нет). Такого нет у большинства интеграций.

1 Откройте рабочее место оператора → меню «Роли доступа» (только для админа, у Битрикс-порталов).

2 Прокрутите вниз до карточки «ID клиента → поля контакта Битрикса».

3 Напротив нужных каналов выберите поле контакта Б24, куда писать id. Поля подтягиваются из вашего Битрикса — удобно завести пользовательские (UF) текстовые поля под каждый id.

4 Включите «Искать дубли по этим ID», если хотите объединять контакты по id. Нажмите «Сохранить». Кнопка «Заполнить существующие» проставит id уже имеющимся контактам.

Запись идёт в текстовые/пользовательские поля контакта. Для нативных мультиполей (мессенджеры/телефон/email) — напишите нам, настроим отдельно.

Нужен нестандартный сценарий (привязка к существующей сделке по своей переменной, вебхуки во внешние системы, кастомная логика) — напишите нам, реализуем.

Интеграция в сайт или внешнюю CRM (API)

Если у вас своя система (сайт, CRM, платформа) — встройте Тат-Чат как канал общения. Модель — как встройка в Битрикс24: операторы работают в нашем окне, встроенном к вам через <iframe> (свой интерфейс чата строить не нужно), а данные синхронизируются по API. Полный справочник эндпоинтов — на адресе вашего Тат-Чата: https://<ваш-адрес>.tat-chats.com/api/v1/docs (адрес указан в личном кабинете).

0. Ключ доступа

В рабочем месте оператора → раздел «API-ключи» создайте ключ и выдайте нужные разделы (скоупы): send (отправка), operators (сотрудники и вход во фрейм), clients (предрегистрация клиентов), плюс чтение (dialogs, messages…). Ключ показывается один раз — храните на бэкенде, во фронт не встраивайте. Авторизация: заголовок Authorization: Bearer <ключ>.

1. Отправлять сообщения клиенту

POST /api/v1/send, тело { "client_id": "…", "text": "…" }. client_id приходит из вебхука входящих (п.2); Тат-Чат сам доставит в тот канал, которым пользуется клиент.

2. Получать входящие (вебхук)

В разделе «API-ключи» → «Вебхук входящих» укажите URL приёмника и получите секрет. На каждое сообщение клиента Тат-Чат шлёт POST на ваш URL с телом { client_id, channel, name, phone, messenger_id, external_id, text, ts } и заголовком X-Signature = HMAC-SHA256(тело, секрет). Проверяйте подпись.

3. Сотрудники как операторы

POST /api/v1/operators (скоуп operators) — идемпотентно по login (ваш id пользователя): нет — создаст и вернёт пин, есть — обновит. /operators/deactivate — отключить уволенного.

4. Встроить рабочее место во фрейм (SSO)

Ваш бэкенд зовёт POST /api/v1/operators/login-link {login} → получает url для вставки в <iframe> — оператор попадает в наше окно уже авторизованным. Опции: client_id — открыть конкретный диалог; phone/contact_id/external_id — открыть форму «Написать первым» с подставленным номером.

5. Привязать клиента заранее (pre-bind)

POST /api/v1/clients (скоуп clients) — { external_id, phone, name }. Когда клиент напишет с этого телефона, в вебхуке придёт ваш external_id — сообщение сразу ляжет на ваш лид (работает для телефонных каналов — WhatsApp/SMS).

6. Написать первым

Первым в Telegram/WhatsApp писать нельзя (баны) — только после обращения клиента. Холодный канал по номеру — SMS: POST /api/v1/sms {phone, template_id} (по шаблону из кабинета).

7. Виджет чата на сайт

Готовая кнопка чата на сайте: в разделе «API-ключи» → «Виджет чата на сайт» включите и скопируйте строку вставки — сообщения посетителей приходят в рабочее место как обычный канал.

Роли сотрудников (в автономном режиме) задаются в разделе «Рабочие места» или полем role при создании оператора. «Роли доступа» — только для встройки в Битрикс24. Нестандартный сценарий — напишите нам.

Поддержка

Вопросы по подключению и работе — пишите на support@tat-chats.com. Правовые документы — в разделе документов.