Битрикс24 и WordPress: карточка клиента и заявки с сайта
Кратко: В этой связке CRM ведёт клиента и сделку, а WordPress принимает заявку и получает обратные события.
- Задача: не терять заявки между сайтом и CRM и не заводить клиента дважды.
- Что проверено: методы
crm.lead.add,crm.contact.add, дедупликация по телефону и email, ограничение частоты REST API, событие отправки формы в популярных плагинах. - Уровень: documented — официальная документация WordPress и Битрикс24.
- Что не проверено: поведение конкретных пользовательских полей и стадий на вашем портале.
Когда нужна интеграция
Заголовок раздела «Когда нужна интеграция»Интеграция нужна, когда заявка должна попасть в CRM с источником, ответственным и историей, а не остаться письмом в почте. Типичные признаки: несколько форм на сайте, разные продукты и направления, менеджеры работают в воронке Битрикс24, а маркетинг считает источники по UTM.
Обратные случаи:
- Нужна только форма обратной связи — у Битрикс24 есть собственные CRM-формы и виджеты на сайт; отдельная интеграция для этого не требуется.
- Нужен лендинг с оплатой и заказом — это уже сценарий WooCommerce, см. WooCommerce и Битрикс24.
- Нужна полная миграция сайта или данных клиентов — это разовый перенос, а не синхронизация; для контента — WordPress и 1С-Битрикс.
Сценарии
Заголовок раздела «Сценарии»Заявка с формы → лид и контакт
Заголовок раздела «Заявка с формы → лид и контакт»- Событие: посетитель отправляет форму «Запросить расчёт»; срабатывает хук плагина форм
(
wpcf7_mail_sent,wpforms_process_complete,gform_after_submission). - Направление: WordPress → Битрикс24.
- Сущности: лид, контакт, телефон, email, источник, UTM-метки, страница-источник.
- Результат: в CRM появляется лид с ответственным по правилу распределения; повторная отправка с тем же телефоном не создаёт второго лида.
Регистрация пользователя → клиент в CRM
Заголовок раздела «Регистрация пользователя → клиент в CRM»- Событие: регистрация в личном кабинете или подписка на рассылку (хук
user_register). - Направление: WordPress → Битрикс24.
- Сущности: контакт, компания (если заполнена), согласие на обработку данных.
- Результат: контакт создаётся без сделки, чтобы маркетинг видел базу, а отдел продаж не получал пустые сделки.
Смена стадии сделки → событие на сайте
Заголовок раздела «Смена стадии сделки → событие на сайте»- Событие: менеджер переводит сделку в стадию «Договор подписан» или «Отказ».
- Направление: Битрикс24 → WordPress.
- Сущности: сделка, стадия, контакт, идентификатор клиента на сайте.
- Результат: на сайте открывается доступ к закрытым материалам или отправляется письмо; при отказе доступ не выдаётся. Обратное событие приходит только при согласии клиента на такую коммуникацию.
Триггеры и действия
Заголовок раздела «Триггеры и действия»| Событие на стороне WordPress | Действие в Битрикс24 | Примечание |
|---|---|---|
| Отправка формы (хук плагина) | crm.lead.add + контакт |
Основной сценарий; поля формы маппятся на поля лида |
user_register |
crm.contact.add |
Без сделки, чтобы не засорять воронку |
| Комментарий или обращение в поддержку | crm.lead.add c типом обращения |
Только если это действительно заявка |
| Изменение статуса заказа на сайте | crm.deal.update |
Для магазинных сайтов — см. сценарий WooCommerce |
| Событие в Битрикс24 | Действие на сайте | Примечание |
|---|---|---|
| Смена стадии сделки | Открыть доступ, отправить письмо, обновить статус | Нужен публичный HTTPS-endpoint и проверка подписи |
| Создание задачи менеджеру | Уведомление в личном кабинете | Требует собственного endpoint на сайте |
| Изменение ответственного | Обновление контакта в профиле | Не критично для MVP, но полезно для поддержки |
Обратный канал в Битрикс24 — исходящие события портала на handler сайта; опроса ради можно
использовать crm.deal.list с фильтром по дате изменения, но это дороже по лимитам.
Варианты реализации
Заголовок раздела «Варианты реализации»- Штатный механизм Битрикс24 — CRM-формы и виджеты: форма живёт на стороне портала, сайт только встраивает её. Подходит, если нужна одна типовая форма без собственной логики.
- Плагин для WordPress — готовые коннекторы к Битрикс24 существуют, но набор поддерживаемых полей и версий у них разный. Критерий выбора: активные обновления, поддержка вашего плагина форм и документированный маппинг полей.
- iPaaS (Make, n8n, Albato) — соединяет форму с CRM без кода; удобно для нескольких источников. Ограничение: логика и секреты живут вне вашего репозитория, а отладка идёт в чужом интерфейсе.
- Custom-интеграция — небольшой MU-плагин: обработчик хука формы →
wp_remote_postв REST API портала с ключом идемпотентности. Даёт контроль над дедупликацией, повторами и журналом; требует сопровождения при обновлении плагина форм.
Критерий выбора простой: если правил больше двух (дедупликация, распределение, повтор при сбое) — custom обычно дешевле в эксплуатации, чем iPaaS.
Данные и соответствие полей
Заголовок раздела «Данные и соответствие полей»| Поле на сайте | Поле Битрикс24 | Ключ соответствия | Примечание |
|---|---|---|---|
| Имя и фамилия | NAME, LAST_NAME |
— | Разделять на стороне сайта или в маппинге |
| Телефон | PHONE[0][VALUE] |
Дедупликация по телефону | Формат E.164, VALUE_TYPE: WORK |
EMAIL[0][VALUE] |
Дедупликация по email | Не обязателен: часть форм только с телефоном | |
| Комментарий | COMMENTS |
— | Ограничить длину, чтобы не потерять текст |
| Форма и страница | SOURCE_ID, пользовательское поле |
— | Источник должен существовать в справочнике портала |
| UTM-метки | Пользовательские поля | — | Создаются заранее в портале; имена не угадываются |
Владелец данных: сайт владеет контентом, первичной заявкой и согласием; CRM владеет жизненным циклом лида, сделкой и историей коммуникаций. Дублировать статус воронки на сайте не нужно — сайт хранит только тот минимум, который нужен для доступа.
Перед запуском
Заголовок раздела «Перед запуском»- Завести на портале входящий вебхук с правами CRM и сохранить его только на сервере.
- Создать пользовательские поля под UTM и источник; зафиксировать их коды в коде интеграции.
- Проверить обязательные поля лида и стадии воронки на целевом портале.
- Добавить чекбокс согласия на обработку персональных данных и сохранять его значение.
- Прогнать на staging: отправка формы, повторная отправка, недоступный портал, дубль по телефону.
- Настроить журнал: время, форма, идентификатор лида, код ответа API.
Ограничения и надёжность
Заголовок раздела «Ограничения и надёжность»- Лимит запросов. REST API портала ограничивает частоту обращений; при массовом импорте заявок нужны пакетная отправка и очередь. Ответ с ошибкой лимита нельзя считать успехом.
- Идемпотентность. Ключом служит пара «идентификатор формы + телефон/email»; повторная доставка не должна создавать второй лид. Перед созданием выполняется поиск по контакту.
- Таймауты. Запрос из обработчика формы не должен держать пользователя: разумный таймаут и отложенная повторная попытка через очередь WP-Cron или внешний воркер.
- Секреты. Вебхук Битрикс24 равен полному доступу к порталу: он хранится в серверной конфигурации, не в JavaScript и не в репозитории; при подозрении на утечку — отзыв и перевыпуск.
- Персональные данные. Передача в CRM требует основания и согласия, а хранение — соблюдения политики; поля с лишними данными (паспорт, медицинские сведения) в лид не передаются.
- Сверка. Раз в сутки полезно сверять число заявок за период по журналу сайта и число лидов в CRM: расхождение означает потерянные события.
Вопросы и ответы
Заголовок раздела «Вопросы и ответы»Нужен ли отдельный сервер для интеграции? Нет, для базового сценария достаточно сайта и портала. Отдельный воркер нужен, если заявок много и требуется гарантированная повторная доставка при недоступности CRM.
Что делать, если портал недоступен в момент отправки? Сохранить заявку в базе сайта и поставить её в очередь повторов; посетителю показать успешную отправку формы, а не ошибку CRM.
Можно ли обойтись только вебхуком без приложения? Для одного портала — да. Для продукта, который ставят на разные порталы, нужен OAuth-доступ с разделением прав.
Как проверить, что интеграция не врёт? Сверить поля в лиде с полями формы на тестовой заявке, проверить дубль по телефону и отказ портала: ни один из трёх случаев не должен создавать «тихий» сбой.