Перейти к содержимому

Битрикс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 появляется лид с ответственным по правилу распределения; повторная отправка с тем же телефоном не создаёт второго лида.
  • Событие: регистрация в личном кабинете или подписка на рассылку (хук 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 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-доступ с разделением прав.

Как проверить, что интеграция не врёт? Сверить поля в лиде с полями формы на тестовой заявке, проверить дубль по телефону и отказ портала: ни один из трёх случаев не должен создавать «тихий» сбой.