---
title: "Интеграция Битрикс24: лиды, сделки и контакты из мессенджеров"
nav_title: "Битрикс24"
url: https://docs.tuk-tuk.online/integrations/bitrix24
markdown: https://docs.tuk-tuk.online/integrations/bitrix24.md
section: "Интеграции"
description: "Как подключить Битрикс24 к tuk-tuk.online через входящий вебхук: создание лидов, сделок и контактов из обращений в мессенджерах, поиск компаний, справочники стадий и статусов."
keywords: ["Битрикс24 Telegram интеграция", "Bitrix24 мессенджер подключить", "CRM Битрикс мессенджеры", "лиды из мессенджеров", "автоматизация продаж Битрикс24", "Битрикс24 чат-бот", "CRM воронка мессенджеры", "Битрикс24 API webhook"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Интеграция Битрикс24 подключается через входящий вебхук (вставляется URL вебхука целиком) и создаёт из обращений в мессенджерах контакты, лиды и сделки, читает компании и справочники стадий и статусов.
>
> - Где: «Интеграции» → Битрикс24 → «Подключить»; одно поле «URL входящего вебхука» (https://mycompany.bitrix24.ru/rest/1/abc123xyz/), адрес портала и токен извлекаются автоматически.
> - Предусловие: входящий вебхук в Битрикс24 («Приложения» → «Вебхуки») с правами crm и user.
> - Проверка при подключении: метод profile; вызовы идут на {портал}/rest/{token}/{метод}.json.
> - Методы: crm.contact.list/add, crm.deal.list/add, crm.lead.list/add, crm.company.list, crm.dealcategory.stage.list, crm.status.list.
> - Вебхук работает от имени сотрудника, который его создал, и с его правами.
>
> Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/integrations/amocrm, https://docs.tuk-tuk.online/integrations/retailcrm, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/ai/lead-converter

# Интеграция Битрикс24

Интеграция создаёт в Битрикс24 лиды, сделки и контакты из обращений в мессенджерах. Клиент пишет в Telegram, менеджер видит лид с телефоном и историей в привычной CRM.

Подключение идёт через входящий вебхук Битрикс24: без OAuth, без приложения в маркетплейсе. Токен вебхука вводится один раз.

## Что синхронизируется

| Сущность Битрикс24 | Чтение | Запись |
|---|---|---|
| Контакты | Поиск по имени, телефону и email, список | Создание из диалога: фамилия, имя, отчество, email, телефон, должность, источник |
| Сделки | Список с фильтрами | Создание с названием, суммой, воронкой, ответственным, источником и комментарием |
| Лиды | Список с фильтрами | Создание из первого обращения: имя, фамилия, телефон, email, источник, комментарий |
| Компании | Поиск и список для привязки к контактам и сделкам | Нет |
| Справочники | Стадии сделок (`crm.dealcategory.stage.list`), статусы лидов (`crm.status.list`) | Нет |

## Что нужно на стороне Битрикс24

- Портал Битрикс24 (облачный или коробочный) с включённым модулем CRM.
- Сотрудник с правом создавать вебхуки: вебхук работает от его имени и с его правами.
- Входящий вебхук с правами `crm` (CRM) и `user` (Пользователи).

## Как подключить


![Подключение Битрикс24](https://docs.tuk-tuk.online/assets/screens/integrations/bitrix24.webp)

1. Поле «URL входящего вебхука».
2. Кнопка подключения.

### Создать вебхук в Битрикс24

1. Откройте Битрикс24 → «Приложения» → «Вебхуки» и нажмите «Добавить вебхук» → «Входящий вебхук».
2. Задайте название, например «tuk-tuk.online», и отметьте права CRM (`crm`) и Пользователи (`user`).
3. Сохраните и скопируйте URL вебхука: он выглядит так.

```text
https://mycompany.bitrix24.ru/rest/1/abc123xyz/
```

Токен доступа уже зашит в URL: часть после `/rest/` (здесь `1/abc123xyz`). Отдельно копировать его не нужно.

### Подключить в tuk-tuk.online

1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите Битрикс24 и нажмите «Подключить»: появится форма с одним полем.
2. Вставьте в поле «URL входящего вебхука» ссылку целиком, например `https://mycompany.bitrix24.ru/rest/1/abc123xyz/`: платформа сама разберёт её на адрес портала и токен.
3. Нажмите «Подключить»: платформа вызовет метод `profile` и при успехе отметит карточку «Интеграция подключена». При неверном токене форма покажет «Неверный Webhook Token Битрикс24».

## Проверить, что работает

1. Нажмите «Управлять» и откройте страницу Битрикс24 в кабинете: во вкладке «Контакты» загрузится список из портала.
2. Создайте тестовый контакт или лид в форме на этой странице: запись появится в 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 и создавайте лид только для новых |
| Вебхук перестал работать | Сотрудник, создавший вебхук, уволен или лишён прав: создайте вебхук от другого сотрудника и обновите токен |