Интеграция создаёт в Битрикс24 лиды, сделки и контакты из обращений в мессенджерах. Клиент пишет в Telegram, менеджер видит лид с телефоном и историей в привычной CRM.
Подключение идёт через входящий вебхук Битрикс24: без OAuth, без приложения в маркетплейсе. Токен вебхука вводится один раз.
#Что синхронизируется
| Сущность Битрикс24 | Чтение | Запись |
|---|---|---|
| Контакты | Поиск по имени, телефону и email, список | Создание из диалога: фамилия, имя, отчество, email, телефон, должность, источник |
| Сделки | Список с фильтрами | Создание с названием, суммой, воронкой, ответственным, источником и комментарием |
| Лиды | Список с фильтрами | Создание из первого обращения: имя, фамилия, телефон, email, источник, комментарий |
| Компании | Поиск и список для привязки к контактам и сделкам | Нет |
| Справочники | Стадии сделок (crm.dealcategory.stage.list), статусы лидов (crm.status.list) | Нет |
#Что нужно на стороне Битрикс24
- Портал Битрикс24 (облачный или коробочный) с включённым модулем CRM.
- Сотрудник с правом создавать вебхуки: вебхук работает от его имени и с его правами.
- Входящий вебхук с правами
crm(CRM) иuser(Пользователи).
#Как подключить
- Поле «URL входящего вебхука».
- Кнопка подключения.
#Создать вебхук в Битрикс24
- Откройте Битрикс24 → «Приложения» → «Вебхуки» и нажмите «Добавить вебхук» → «Входящий вебхук».
- Задайте название, например «tuk-tuk.online», и отметьте права CRM (
crm) и Пользователи (user). - Сохраните и скопируйте URL вебхука: он выглядит так.
https://mycompany.bitrix24.ru/rest/1/abc123xyz/Токен доступа уже зашит в URL: часть после /rest/ (здесь 1/abc123xyz). Отдельно копировать его не нужно.
#Подключить в tuk-tuk.online
- Откройте раздел Интеграции, выберите Битрикс24 и нажмите «Подключить»: появится форма с одним полем.
- Вставьте в поле «URL входящего вебхука» ссылку целиком, например
https://mycompany.bitrix24.ru/rest/1/abc123xyz/: платформа сама разберёт её на адрес портала и токен. - Нажмите «Подключить»: платформа вызовет метод
profileи при успехе отметит карточку «Интеграция подключена». При неверном токене форма покажет «Неверный Webhook Token Битрикс24».
#Проверить, что работает
- Нажмите «Управлять» и откройте страницу Битрикс24 в кабинете: во вкладке «Контакты» загрузится список из портала.
- Создайте тестовый контакт или лид в форме на этой странице: запись появится в CRM Битрикс24 у сотрудника, от имени которого создан вебхук.
#Что происходит после подключения
| Событие | Вызов Битрикс24 |
|---|---|
| Создание контакта из диалога | crm.contact.add |
| Создание сделки | crm.deal.add |
| Создание лида | crm.lead.add |
| Поиск контакта, сделки, лида, компании | crm.contact.list, crm.deal.list, crm.lead.list, crm.company.list |
| Загрузка стадий и статусов | crm.dealcategory.stage.list, crm.status.list |
Все вызовы идут POST-запросами на {адрес портала}/rest/{token}/{метод}.json. Авторизация встроена в URL, отдельных запросов на токен нет.
#Ограничения
- Вебхук действует от имени конкретного сотрудника Битрикс24 и наследует его права на CRM.
- Права вебхука задаются при создании; для интеграции достаточно
crmиuser. - URL вебхука содержит токен: не публикуйте его и не пересылайте в открытых чатах.
- Двусторонней переписки внутри Битрикс24 нет: сообщения клиентов остаются в tuk-tuk.online, в CRM уходят контакты, лиды и сделки.
#Частые проблемы
| Проблема | Что делать |
|---|---|
| Контакты не создаются | Проверьте, что у вебхука есть право crm |
| Ошибка 401 или «Неверный Webhook Token» | Скопируйте URL вебхука заново из Битрикс24: администратор мог пересоздать секретный код |
| Сделка не в той воронке | При создании сделки укажите воронку и стадию из справочника стадий |
| Лиды дублируются | Перед созданием ищите контакт по телефону или email и создавайте лид только для новых |
| Вебхук перестал работать | Сотрудник, создавший вебхук, уволен или лишён прав: создайте вебхук от другого сотрудника и обновите токен |