CRM API: как связать рекламу, заявки и продажи

TL;DR

• CRM API нужен, чтобы маркетинг видел не только заявки, но и дальнейшие статусы: qualified, meeting, approved, paid, lost.
• Главный ключ интеграции - стабильный lead_id плюс рекламные идентификаторы: UTM, GCLID, fbclid, ttclid, client_id.
• amoCRM и Bitrix24 поддерживают webhooks и API-подходы, но требуют аккуратной работы с правами, секретами и лимитами.
• Не отправляйте рекламные события из CRM без фильтра качества. Иначе алгоритмы будут учиться на мусоре.
• CRM-интеграция ломается не из-за API, а из-за процессов: менеджеры не ведут статусы, поля заполняются руками, нет владельца данных.

1. Зачем маркетологу CRM API

Лендинг знает, что человек оставил форму. CRM знает, что с этим человеком произошло дальше. Между этими мирами часто пропасть.

Если связки нет, маркетинг оптимизируется на верх воронки:

• заявка отправлена;
• звонок заказан;
• квиз пройден;
• форма заполнена.

Но бизнесу нужны другие события:

• дозвонились;
• заявка качественная;
• встреча назначена;
• кредит одобрен;
• договор подписан;
• деньги получены.

CRM API позволяет возвращать эти статусы в аналитику и рекламные системы.

2. Какие данные нужно сохранить

В момент создания лида сохраните:

Поле	Зачем
lead_id	Главный внутренний ключ
UTM	Источник, канал, кампания, креатив
GCLID/GBRAID/WBRAID	Google Ads attribution
fbclid/fbc/fbp	Meta matching
ttclid	TikTok matching
client_id/session_id	Связка с аналитикой
landing URL	Контекст заявки
form name	Какая форма сработала
consent	Можно ли использовать данные

Если этих полей нет в CRM, дальнейшая интеграция превращается в гадание. Sales может закрыть сделку, но маркетинг не поймет, какой канал ее привел.

3. API vs webhook

API и webhook часто путают.

Механика	Что делает
API request	Вы сами спрашиваете или меняете данные в CRM
Webhook	CRM сама сообщает вашему endpoint, что событие произошло

Пример API: раз в час забрать все сделки со статусом paid.

Пример webhook: CRM сразу отправляет уведомление, когда сделка перешла в approved.

Для маркетинговых пайплайнов часто нужен гибрид: webhooks для быстрых событий, scheduled API sync для сверки и восстановления пропущенных данных.

4. amoCRM и Bitrix24

amoCRM позволяет подписывать webhooks на события и отправлять уведомления на заданный URL. Это удобно для событий по сделкам и лидам.

Bitrix24 дает REST API и webhooks. В webhook URL уже зашит секрет, поэтому его нельзя хранить в публичном коде, таск-менеджерах и скриншотах.

Серьезная интеграция не должна отправлять событие напрямую из CRM в рекламную платформу без промежуточного слоя. Нужны validation, retry, logs, rate limiting и защита от дублей.

5. Какие CRM-статусы отправлять в рекламу

Не каждый статус полезен.

Статус	Что делать
New lead	Можно использовать для базовой аналитики
Contacted	Обычно слабый сигнал
Qualified	Хороший сигнал для leadgen
Approved	Отличный сигнал для финтеха
Paid / issued	Лучший сигнал, если объема достаточно
Lost	Не отправлять как conversion, но анализировать
Duplicate / spam	Исключать из оптимизации

Если отправлять в рекламные API каждый новый лид, алгоритм будет искать людей, которые дешево оставляют заявки. Если отправлять qualified или paid, он будет искать людей, которые ближе к выручке.

6. Локальный контекст СНГ/РК

В локальных компаниях CRM часто является не системой данных, а рабочим журналом sales-команды. Поля могут заполняться руками, статусы использоваться по-разному, менеджеры могут создавать дубли.

Перед интеграцией нужно договориться:

• что считается качественным лидом;
• кто меняет статус;
• какие поля обязательны;
• как обрабатываются дубли;
• где хранится рекламная атрибуция;
• кто отвечает за ошибки API.

Для Kaspi, банков, страхования и недвижимости важно также учитывать длинный цикл сделки. Маркетинговая ценность может появиться через несколько дней после заявки.

7. Ошибки

Ошибка	Последствие
Нет lead_id	Невозможно надежно связать события
Webhook URL попал в общий доступ	Риск доступа к CRM
Нет retry	События теряются при временной ошибке
Нет дедупликации	Рекламные платформы получают дубли
Нет договоренности по статусам	Один менеджер ставит qualified, другой нет
Все лиды считаются ценными	Алгоритмы оптимизируются на мусор

8. Чеклист

• CRM хранит UTM и click IDs.
• У каждого лида есть уникальный ID.
• Статусы описаны и одинаково используются sales-командой.
• Webhook endpoint защищен.
• Секреты не лежат в коде и таблицах.
• Есть очередь или retry-механика.
• Есть лог входящих и исходящих событий.
• Quality events уходят в Ads/BI только после фильтра.

9. Видео

10. Главный совет

CRM API не заменяет дисциплину в CRM. Сначала наведите порядок в статусах и обязательных полях, потом отправляйте quality events в рекламу.

Sources / Notes

• amoCRM Developers: Вебхуки
• Bitrix24 Helpdesk: Create webhooks and apps in Bitrix24
• Google Ads Help: Set up offline conversion imports using GCLID