Интеграция с WordPress (Contact Form 7)

Заявки форм Contact Form 7 в CRM с источником визита. Скачать, установить и настроить.

Плагин передаёт заявки форм Contact Form 7 в Linkodium CRM вместе с источником визита и ставит на страницы сайта общий код CRM. Письма Contact Form 7 и ответ посетителю работают как раньше: CRM получает заявку параллельно, а ошибка связи с CRM форму не ломает.

Скачать: lkdm-cf7.zip, версия 5.0.0 от 10 ноября 2026. Нужны WordPress 5.8 или новее, PHP 7.4 или новее и плагин Contact Form 7.

1. Ключ API

В CRM откройте «Настройки компании» → «API-ключи» и нажмите «Выпустить ключ».
Выберите сотрудника и отметьте область «Создание заявок» (leads:create).
Скопируйте ключ: он показывается один раз и начинается с crm_.

Ключ работает с правами выбранного сотрудника. Выпускайте его владельцу, администратору или сотруднику с правом «Менять статус, в том числе отмечать спам»: заявки, которые Contact Form 7 счёл спамом, плагин передаёт с этапом «Спам», и без этого права CRM их не примет. Кому назначаются заявки с ключа, рассказано в документации API.

2. Общий код CRM

Общий код связывает заявку с визитом: откуда пришёл посетитель, с какой рекламы и по какому запросу. Он же подключает модули, выбранные в CRM: антиспам и чат на сайте.

Откройте «Настройки компании» → «Трекинг».
В разделе «Сайты» добавьте адрес сайта. Если сайт открывается и с www., и без него без переадресации, добавьте оба адреса.
В разделе «Код на сайт» найдите адрес вида https://crm.linkodium.com/lks/КЛЮЧ.js. Часть КЛЮЧ и есть публичный ключ общего кода, он понадобится в настройках плагина.

Публичный ключ секретом не является: им можно только отправить касание с сайтов из вашего списка. Подробнее о коде: Сквозная аналитика.

3. Установка и обновление

Скачайте архив lkdm-cf7.zip, не распаковывая его.
В админке WordPress откройте «Плагины» → «Добавить новый» → «Загрузить плагин», выберите архив и нажмите «Установить».
Нажмите «Активировать». В списке плагинов появится «Linkodium CRM для Contact Form 7».

Обновление. Загрузите новый архив тем же способом: WordPress предложит «Заменить установленную версию на загруженную». Ключ API, общий код и настройки форм сохраняются. Если на сайте стоит плагин «Linkodium CF7» версии 4, это тот же плагин: обновите его этим архивом.

4. Настройки плагина

Откройте «Настройки» → «Linkodium CRM» (или ссылку «Настройки» у плагина в списке).

Ключ API: вставьте ключ из шага 1. После сохранения поле пустое, а над ним видно начало ключа: сам ключ хранится только на сервере сайта и в код страниц не попадает. Чтобы заменить ключ, вставьте новый, чтобы удалить, отметьте «удалить ключ».
Публичный ключ общего кода: ключ из шага 2.
Общий код CRM: отметьте «ставить на все страницы сайта». Если код CRM уже вставлен в шаблон сайта вручную, галочку не ставьте, чтобы код не стоял дважды.

Нажмите «Сохранить». На этой же странице видно, сколько форм отправляют заявки в CRM. Если на сайте включено кеширование страниц, очистите кеш, чтобы код появился на всех страницах.

5. Настройка формы

Откройте форму в разделе «Контактные формы» и перейдите на вкладку «CRM».

Отметьте «Включено».
В списке «Интеграция» оставьте «CRM (crm.linkodium.com)».
Заполните поля заявки тегами формы в квадратных скобках. Над таблицей перечислены теги этой формы.
Нажмите «Сохранить» формы.

Поле заявки	Пример	Что это
Имя	`[your-name]`	Имя клиента
Телефон	`[your-phone]`	Телефон, по нему CRM находит повторные обращения
Email	`[your-email]`	Email клиента
Сообщение	`[your-message]`	Текст обращения, можно собрать из нескольких тегов
Произвольное поле	`form:Расчёт стоимости\|Город:[city]`	Части через `\|`. Часть `form:` задаёт потребность клиента (без неё это название формы), остальные строки добавляются к сообщению

Достаточно одного из трёх: имени, телефона или email. Если в форме нет ни одного, заявка придёт с названием формы вместо имени.

6. Проверка

Откройте страницу с формой и отправьте её со своими данными.
В CRM в разделе «Заявки» появится новая заявка с источником «Сайт ваш-домен» и блоком визита в карточке.
Если заявки нет, откройте вкладку «CRM» формы и раскройте «DEBUG LOG»: там последняя отправка (адрес, поля, ответ CRM с кодом и номером заявки). Ключ API в журнал не попадает.

Проверить общий код можно в браузере: в коде страницы есть crm.linkodium.com/lks/, а в форме после загрузки страницы появляется скрытое поле lkt_token.

7. Что уходит в CRM

Данные	Откуда
Имя, телефон, email, сообщение	Поля заявки на вкладке «CRM» формы
Потребность клиента	Название формы или часть `form:` произвольного поля
Источник	«Сайт» и домен сайта
Страница формы, страница входа, реферер	Адрес страницы с формой и первая страница визита (плагин помнит её 30 минут после последнего просмотра)
Метки UTM	Поля формы, которые заполняет общий код, иначе адрес страницы входа
ClientID Яндекс Метрики	Поле формы или cookie `_ym_uid`
Метка визита	Скрытое поле `lkt_token`, его добавляет общий код CRM
IP-адрес и браузер	Запрос посетителя к сайту

У каждой отправки свой номер (cf7:домен:форма:отправка), он же ключ идемпотентности: если запрос повторится, вторая заявка не появится. Таймаут запроса 5 секунд.

8. Спам и антиспам

Спам по оценке Contact Form 7 (Akismet, reCAPTCHA, свои правила) тоже уходит в CRM, сразу на этап «Спам» и без уведомлений. Если фильтр ошибся, заявку легко найти и вернуть.
Антиспам CRM включается в «Настройки компании» → «Трекинг», блок «Модули скрипта». Заявки плагина проверяются: в них есть метка визита и страница формы. Скрытое поле-ловушку lkt_hp плагин тоже передаёт. Режимы и то, что видно в карточке: Антиспам.
Не проверять. Чтобы антиспам CRM не проверял заявки этого сайта, на вкладке «API-ключи» нажмите у его ключа «Не проверять заявки на спам». Спам по оценке Contact Form 7 по-прежнему придёт на этап «Спам».

9. Свой обработчик формы

Если заявки формы должен принимать ваш же сервер (например, чтобы передать их ещё и в другую систему), выберите интеграцию «Свой обработчик (адрес API)», укажите адрес и сопоставьте теги формы с параметрами. Плагин добавит к запросу lkt_token, lkt_hp, ym_client_id, метки UTM и номер отправки lkdm_submission. Обработчик передаёт заявку в CRM сам, как описано на странице «Формы сайта и API»: метку визита полем tracking_token, номер отправки в заголовке Idempotency-Key.

10. Частые проблемы

Что видно	Что делать
В DEBUG LOG ошибка `no_api_key`	Ключ API не сохранён: вставьте его в «Настройки» → «Linkodium CRM».
Ответ CRM `401`	Ключ отозван или сотрудник ключа отключён. Выпустите новый ключ и сохраните его в плагине.
Ответ CRM `403`, только у спама	У сотрудника ключа нет права «Менять статус, в том числе отмечать спам». Дайте право или выпустите ключ администратору.
Ответ CRM `400`	В заявке нет ни имени, ни телефона, ни email, или email в неверном формате. Проверьте теги в полях заявки.
Заявки приходят без визита, в форме нет поля `lkt_token`	Общий код не загрузился: проверьте галочку «ставить на все страницы сайта», очистите кеш страниц, добавьте сайт в список «Сайты». Если на сайте есть заголовок Content-Security-Policy, разрешите `https://crm.linkodium.com` в `script-src` и `connect-src`.
В списке интеграций формы есть «a.linkodium.com (прежняя)»	Форма настроена на прежнюю систему. Выберите «CRM (crm.linkodium.com)», проверьте поля заявки и сохраните форму.

11. Версии

5.0.0, 10 ноября 2026. Плагин называется «Linkodium CRM для Contact Form 7». CRM основная интеграция формы, прежняя интеграция a.linkodium.com скрыта (форма, у которой она осталась, работает и подсказывает перейти на CRM). На странице настроек подсказки, число форм с отправкой и ссылка на справку, в списке плагинов ссылки «Настройки» и «Справка». Отправка и настройки не менялись.
4.10, 10 ноября 2026. Интеграция «CRM»: заявки сразу в Linkodium CRM, в том числе спам на этап «Спам». Общий код CRM на всех страницах. Формы прежней интеграции переходят на CRM, как только сохранён ключ API. Свой обработчик получает метку визита и UTM.
4.9, 6 ноября 2026. Страница входа и реферер хранятся в cookie, а не в сессии: страницы сайта можно кешировать.

Модуль для сайтов на 1С-Битрикс: Интеграция с 1С-Битрикс.