# Bitrix24 CRM

Разбирайте воронку Битрикс24 и находите потерянные лиды

CRM для управления сделками, контактами и лидами

## Как агент работает с Bitrix24 CRM

Агент обращается к порталу через входящий вебхук: его URL уже содержит и адрес, и ключ, поэтому запросы идут REST-методами вроде crm.deal.list прямо в ваш Битрикс24 — облачный или коробочный. Он читает сделки, лиды, контакты, компании и счета, считает конверсию по стадиям, активность менеджеров за период и суммы закрытий. Длинные списки забираются страницами, а о создании и изменении сделок портал может присылать события сам — тогда реакция не ждёт следующего опроса.

Воронка в Битрикс24 разорвана надвое: лид и сделка — разные сущности, и при конвертации из лида рождаются сразу сделка, контакт и компания. Считать конверсию по одним сделкам значит потерять верх воронки, поэтому агент связывает лид с тем, во что он превратился. Стадии тоже не универсальны: у каждого направления сделок свой набор, а часть смысла лежит в пользовательских полях — их агент читает вместе со стандартными.

На запись агент ставит задачи с дедлайном и контекстом и двигает сделки по стадиям, а карточку перед правкой перечитывает: портал не запирает запись от параллельных изменений. Перед созданием контакта или компании он ищет дубли по телефону и почте: повторный лид в Битрикс24 ничего не блокирует и спокойно ложится поверх существующей базы. Массовый импорт и поиск дублей идут заметно медленнее обычных запросов — портал на такие методы отвечает неохотно, и лучше подождать, чем упереться в отказ.

Ссылка вебхука хранится зашифрованной и отзывается в том же разделе «Разработчикам → Другое»; отдельной авторизации портал не требует — ключ едет внутри URL каждого запроса. Частоту запросов агент держит невысокой: лимит портала делится со всеми интеграциями сразу, поэтому длинные выборки он проходит страницами, а не одним махом. Если метод закрыт правами или сделок за период не было, он скажет это прямо, а не отдаст пустую таблицу.

## Сценарии интеграции

### Разбор воронки и потерянных лидов
Агент посчитает конверсию по стадиям, найдёт лиды без ответственного и сделки, брошенные после первого касания.

### Еженедельный отчёт по продажам
Агент соберёт закрытые сделки, суммы и активность менеджеров за неделю и пришлёт сводку в Telegram к планёрке.

### Синхронизация CRM с учёткой
Агент сверит сделки Битрикс24 с оплатами в банке или 1С и покажет, какие выигранные сделки так и не оплачены.

### Задачи по зависшим сделкам
Агент найдёт сделки без задач и без движения, создаст менеджерам задачи с дедлайном и контекстом.

### Дубли в базе клиентов
Агент пройдёт по контактам и компаниям, найдёт дубли по телефону и почте и покажет, где один клиент завёлся дважды под разными менеджерами.

### Новый лид сразу в чат
Агент поймает событие о новом лиде по вебхуку, подтянет карточку с контактами и источником и напишет дежурному менеджеру, не дожидаясь опроса.

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

**Перед подключением**

- Платный тариф Битрикс24: на бесплатном REST API закрыт.
- Портал Битрикс24 — облачный на *.bitrix24.ru или коробка на своём домене.

### Войдите под сотрудником, видящим всю CRM
Откройте свой портал <ваш-домен>.bitrix24.ru. Вебхук работает с правами создателя: если он видит только свои сделки, столько же увидит и агент.

### Создайте «Входящий вебхук»
«Приложения → Разработчикам», вкладка «Готовые сценарии» → блок «Другое» → «Входящий вебхук».

### Отметьте права вебхука
Для чтения воронки хватит галочки CRM. Чтобы агент создавал задачи и двигал сделки, добавьте «Задачи»; права меняются и позже.

### Скопируйте URL вебхука
Нужна ссылка вида https://<ваш-домен>.bitrix24.ru/rest/1/<секретный код>/ — со слешем на конце и без имени метода. Код виден только создателю вебхука.

## Частые вопросы

### Как подключить Битрикс24?
Входящим вебхуком: в Битрикс24 откройте «Разработчикам → Другое → Входящий вебхук», выберите права и вставьте полученный URL при подключении. Ссылка хранится в зашифрованном виде.

### Какие права нужны вебхуку?
Для аналитики достаточно CRM (чтение). Если хотите, чтобы агент создавал задачи и двигал сделки, добавьте права на запись CRM и «Задачи». Права всегда можно сузить — агент попросит недостающее, когда упрётся.

### Облачный и коробочный Битрикс24 оба работают?
Да, вебхук-механика одинакова: подключается и облачный портал *.bitrix24.ru, и коробка на вашем домене.

### Агент увидит изменения в сделках сразу?
Да, агент читает REST API в момент задачи. Дополнительно коннектор принимает вебхуки о создании и изменении сделок — на них можно вешать автоматические реакции.

[Открыть Bitrix24 CRM](https://www.bitrix24.ru)