Integration of CF7 and Bitrix24 Pro

Integration of CF7 and Bitrix24 Pro

2.000 руб./навсегда

Плагин интеграции Contact Form 7 и CRM Bitrix24. Заявки автоматически попадают в Bitrix24 в разделы «Лиды», «Сделка», «Задача», «Контакт», «Компания». Возможно создавать неограниченное количество форм с любыми типами данных, которые предусмотрены в api Bitrix24. А так же можно настроить UTM метки, которые позволят отслеживать рекламные каналы с которых приходят заявки.

Плагин покупается один раз и навсегда. Помощь в настройке плагина нашими силами оценивается отдельно. Подробная инструкция в настройке плагина описана в документации ниже.

Категория:

Инструкция

Эта документация даст вам представление о том, как структурирован плагин Integration of CF7 and Bitrix24 Pro, и поможет вам в выполнении общих функций.


Установка

Чтобы начать работу с плагином, выполните следующие действия:

  1. Деактивируйте плагин Integration of CF7 and Bitrix24 и загрузите плагин Integration of CF7 and Bitrix24 Pro. Для этого перейдите в панель администратора -> плагины -> добавить плагин, и загрузите .zip архив на сайт.
  2. Активируйте установленный плагин.
  3. В выпадающем меню Contact form 7, выберите вкладу интеграция Bitrix24, заполните все поля:
    • Домен Bitrix — NAME.bitrix24.ru
    • Порт — Как правило 443
    • REST api path — /crm/configs/import/lead.php
    • Login — Логин для входа в Bitrix24
    • Password — Пароль для входа в Bitrix24
    • User id — Чтобы узнать id пользователя, войдите в панель управления Bitrix24 > Сотрудники > Вкладка сотрудники (Посмотрите скриншот)
    • Webhook code Bitrix24 — Для получения Webhook, войдите в панель управления Bitrix24 > Разработчкам > Готовые сценарии > Другое > Входящий вебхук (Получение Вебхука). Вебхук должен иметь набор прав: CRM, Сайты, Задачи, Задачи (расширенные права), Пользователи (Посмотрите скриншот)

    Сохраните данные.


Создание формы

Создайте форму в плагине Contact form 7, сохраните ее.

Bitrix24 leads

На данной вкладке находится список доступных лидов для генерации, это:

  • Lead — Лиды
  • Deal — Сделка
  • Tasks — Задачи
  • Contact — Контакт
  • Company — Компания

Типы лидов

Lead — Лиды

Поле Описание Тип Примечание
ADDRESS Адрес контакта string
ADDRESS_2 Вторая страница адреса string В некоторых странах принято разбивать адрес на 2 части
ADDRESS_CITY Город string
ADDRESS_COUNTRY Страна string
ADDRESS_COUNTRY_CODE Код страны string
ADDRESS_POSTAL_CODE Почтовый индекс string
ADDRESS_PROVINCE Область string
ADDRESS_REGION Район string
ASSIGNED_BY_ID Связано с пользователем по ID user
BIRTHDATE Дата рождения date
COMMENTS Комментарии string
COMPANY_ID Привязка лида к компании crm_company
COMPANY_TITLE Название компании, привязанной к лиду crm_company
CONTACT_ID Привязка лида к контакту crm_contact
CREATED_BY_ID Кем создана user Только для чтения
DATE_CREATE Дата создания datetime Только для чтения
DATE_MODIFY Дата изменения datetime Только для чтения
EMAIL Адрес электронной почты crm_multifield Множественное
HAS_EMAIL Проверка заполненности поля электронной почты char Только для чтения
HAS_PHONE Проверка заполненности поля телефон char Только для чтения
HONORIFIC Вид обращения crm_status
ID Идентификатор контакта integer Только для чтения
IM Мессенджеры crm_multifield Множественное
IS_RETURN_CUSTOMER Признак повторного лида char Только для чтения
MODIFY_BY_ID Идентификатор автора последнего изменения user Только для чтения
NAME Имя string Обязательное
OPENED Доступен для всех char
ORIGINATOR_ID Идентификатор источника данных string Используется только для привязки к внешнему источнику.
ORIGIN_ID Идентификатор элемента в источнике данных string Используется только для привязки к внешнему источнику.
ORIGIN_VERSION Оригинальная версия string Используется для защиты данных от случайного перетирания внешней системой. Если данные были импортированы и не изменялись во внешней системе, то такие данные могут быть редактированы в CRM без опасения, что следующая выгрузка приведет к перетиранию данных
PHONE Телефон контакта crm_multifield Множественное
POST Должность string
SECOND_NAME Отчество string Обязательное
SOURCE_DESCRIPTION Описание источника string
SOURCE_ID Источник crm_status Какие значения может принимать
STATUS_DESCRIPTION string
STATUS_ID Статус string Какие значения может принимать
STATUS_SEMANTIC_ID string F (failed) — обработан неуспешно,
S (success) — обработан успешно,
P (processing) — лид в обработке.
TITLE Название лида string Обязательное
UTM_CAMPAIGN Обозначение рекламной кампании string
UTM_CONTENT Содержание кампании string Например, для контекстных объявлений.
UTM_MEDIUM Тип трафика string CPC (объявления), CPM (баннеры)
UTM_SOURCE Рекламная система string Yandex-Direct, Google-Adwords и другие.
UTM_TERM Условие поиска кампании string Например, ключевые слова контекстной рекламы.
WEB URL ресурсов лида crm_multifield Множественное

Внимание! Для данного типа Лидов достаточно заполнения Title, все остальные поля — не обязательны.

STATUS_ID – Статусы для лидов

ЗНАЧЕНИЕ НАЗВАНИЕ
NEW Не обработан
ASSIGNED Назначен ответственный
DETAILS Уточнение информации
CANNOT_CONTACT Не удалось связаться
IN_PROCESS В работе
ON_HOLD Обработка приостановлена
RESTORED Сконвертирован
CONVERTED Восстановлен
JUNK Некачественный лид

Пример: [hidden STATUS_ID 'IN_PROCESS'] — передаем скрытое поле со статусом лида в значении «В работе». Для разных тарифов Битрикс24 доступно разное количество статусов.

SOURCE_ID – Источники

ЗНАЧЕНИЕ НАЗВАНИЕ
CALL Звонок
EMAIL Электронная почта
WEB Веб-сайт
ADVERTISING Реклама
PARTNER Существующий клиент
RECOMMENDATION По рекомендации
TRADE_SHOW Выставка
WEBFORM CRM-форма
CALLBACK Обратный звонок
RC_GENERATOR Генератор продаж
STORE Интернет-магазин
OTHER Другое

Пример: [hidden SOURCE_ID 'STORE'] — передаем скрытое поле с указанием источника лида в значении «Интернет-магазин».

Поле Описание Тип Примечание
ADDITIONAL_INFO Дополнительная информация string
ASSIGNED_BY_ID Связано с пользователем по ID user
BANK_DETAIL_ID ID банковского реквизита integer
BEGINDATE Дата начала date
CATEGORY_ID Идентификатор направления crm_category Неизменяемое. Если не передавать это поле при создании сделки, то сделка создастся в общем направлении.
CLOSED Завершена char
CLOSEDATE Дата завершения date
COMMENTS Коментарии string
COMPANY_ID Идентификатор привязанной компании crm_company
CONTACT_ID Идентификатор привязанного контакта crm_contact Устаревший. Сохраняется для совместимости
CONTACT_IDS Идентификатор привязанного контакта crm_contact
CREATED_BY_ID Создано пользователем user Только для чтения
CURRENCY_ID Идентификатор валюты сделки crm_currency
DATE_CREATE Дата создания datetime Только для чтения
DATE_MODIFY Дата изменения datetime Только для чтения
ID Идентификатор сделки integer Только для чтения
IS_NEW Флаг новой сделки (т. е. сделка в первой стадии) char
IS_RECURRING Флаг шаблона регулярной сделки (если стоит Y, то это не сделка, а шаблон) char
IS_RETURN_CUSTOMER Признак повторного лида char
LEAD_ID Идентификатор привязанного лида crm_lead Только для чтения
LOCATION_ID Местоположение клиента location Служебный, не рекомендуется к использованию.
MODIFY_BY_ID Идентификатор автора последнего изменения user Только для чтения
OPENED Доступен для всех char
OPPORTUNITY Сумма double
ORIGINATOR_ID Идентификатор источника данных string Используется только для привязки к внешнему источнику.
ORIGIN_ID Идентификатор элемента в источнике данных string Используется только для привязки к внешнему источнику.
PROBABILITY Вероятность integer
QUOTE_ID Идентификатор квоты crm_quote
REQUISITE_ID Идентификатор реквизита
STAGE_ID Идентификатор стадии crm_status
STAGE_SEMANTIC_ID Имя string
SOURCE_ID
SOURCE_DESCRIPTION Дополнительно об источнике. string Текстовое поле
TAX_VALUE Ставка налога double
TITLE Название string Обязательное.
TYPE_ID Тип сделки crm_status Используется только для привязки к внешнему источнику.
UTM_CAMPAIGN Обозначение рекламной кампании string
UTM_CONTENT Содержание кампании string Например, для контекстных объявлений.
UTM_MEDIUM Тип трафика string CPC (объявления), CPM (баннеры)
UTM_SOURCE Рекламная система string Yandex-Direct, Google-Adwords и другие.
UTM_TERM Условие поиска кампании string Например, ключевые слова контекстной рекламы.

Внимание! Для данного типа поля достаточка заполненного значения Title.

Название Описание Чтение Запись* Сортировка Фильтрация
TITLE Название задачи. + + + +
DESCRIPTION Описание задачи. + +
DEADLINE Крайний срок. + + +
START_DATE_PLAN Плановая дата начала. + + + +
END_DATE_PLAN Плановая дата завершения. + + +
PRIORITY Приоритет. + + + +
ACCOMPLICES Соисполнители (идентификаторы пользователей). + +
AUDITORS Наблюдатели (идентификаторы пользователей). + +
TAGS Теги (при добавлении — просто массив тегов в виде текста).
CTasks::GetList() не возвращает поля тегов. CTaskItem::getInstance()->getTags() возвращает массив имен тегов.
+ +
ALLOW_CHANGE_DEADLINE Флаг «Разрешить ответственному менять крайний срок». + + +
TASK_CONTROL Флаг «Принять работу после завершения задачи». + +
PARENT_ID Идентификатор родительской задачи. + + +
DEPENDS_ON Идентификатор предыдущей задачи. + + +
GROUP_ID Идентификатор рабочей группы. + + + +
RESPONSIBLE_ID Идентификатор ответственного. + + + +
TIME_ESTIMATE Плановые трудозатраты. + + + +
CREATED_BY Идентификатор постановщика. + + + +
DECLINE_REASON Причина отклонения задачи. + +
STATUS Мета-статус задачи. + + + +
DURATION_PLAN Планируемая длительность в часах или днях. + +
DURATION_TYPE Тип единицы измерения в планируемой длительности: days, hours или minutes. + +
MARK Оценка по задаче (возможные значения P (положительная) и N (отрицательная)). + + + +
ALLOW_TIME_TRACKING Флаг включения учета затраченного времени по задаче. + + + +
ADD_IN_REPORT Флаг включения задачи в отчет по эффективности. + + +
FORUM_ID Идентификатор форума Форум в данном случае — понятие техническое. Сам форум нигде на портале не используется. , в котором хранятся комментарии к задаче. +
FORUM_TOPIC_ID Идентификатор темы форума Форум в данном случае — понятие техническое. Сам форум нигде на портале не используется. Комментарии к задаче хранятся в топике форума. , в котором хранятся комментарии к задаче. + +
MATCH_WORK_TIME Флаг, который показывает, что даты исполнения и крайний срок должны всегда устанавливаться в рабочее время. + + + +

Внимание! Для создания лида данного типа, должны быть заполнены 2 поля — TITLE(Название задачи) и RESPONSIBLE_ID(ID ответственного за задачу)

Поле Описание Тип Примечание
ADDRESS Адрес контакта string
ADDRESS_2 Вторая страница адреса string В некоторых странах принято разбивать адрес на 2 части
ADDRESS_CITY Город string
ADDRESS_COUNTRY Страна string
ADDRESS_COUNTRY_CODE Код страны string
ADDRESS_POSTAL_CODE Почтовый индекс string
ADDRESS_PROVINCE Область string
ADDRESS_REGION Район string
ASSIGNED_BY_ID Связано с пользователем по ID user
BIRTHDATE Дата рождения date
COMMENTS Комментарии string
COMPANY_ID Привязка контакта к компании crm_company Устаревший. Сохраняется для совместимости.
COMPANY_IDS Привязка контакта к нескольким компаниям. crm_company
CREATED_DY_ID Кем создана user Только для чтения
DATE_CREATE Дата создания datetime Только для чтения
DATE_MODIFY Дата изменения datetime Только для чтения
EMAIL Адрес электронной почты crm_multifield Множественное
EXPORT Участвует ли контакт в экспорте. Eсли N, то выгрузить его невозможно. char Защита от сотрудников, которые хотят украсть базу клиентов.
FACE_ID Привязка к лицам из модуля faceid integer
HAS_EMAIL Проверка заполненности поля электронной почты char Только для чтения
HAS_PHONE Проверка заполненности поля телефон char Только для чтения
HONORIFIC Вид обращения crm_status
ID Идентификатор контакта integer Только для чтения
IM Мессенджеры crm_multifield Множественное
LAST_NAME Фамилия string Обязательное
LEAD_ID Идентификатор лида, связанного с контактом crm_lead Только для чтения
MODIFY_BY_ID Идентификатор автора последнего изменения user Только для чтения
NAME Имя string Обязательное
OPENED Доступен для всех char
ORIGINATOR_ID Идентификатор источника данных string Используется только для привязки к внешнему источнику.
ORIGIN_ID Идентификатор элемента в источнике данных string Используется только для привязки к внешнему источнику.
ORIGIN_VERSION Оригинальная версия string Используется для защиты данных от случайного перетирания внешней системой. Если данные были импортированы и не изменялись во внешней системе, то такие данные могут быть редактированы в CRM без опасения, что следующая выгрузка приведет к перетиранию данных
PHONE Телефон контакта crm_multifield Множественное
PHOTO Фото контакта file
POST Должность string
SECOND_NAME Отчество string Обязательное
SOURCE_DESCRIPTION Описание источника string Текстовое поле
SOURCE_ID Идентификатор источника crm_status Статус из справочника. Список возможных идентификаторов можно получить методом crm.status.list с фильтром filter[ENTITY_ID]=SOURCE
TYPE_ID Идентификатор типа crm_status Статус из справочника
UTM_CAMPAIGN Обозначение рекламной кампании string
UTM_CONTENT Содержание кампании string Например, для контекстных объявлений.
UTM_MEDIUM Тип трафика string CPC (объявления), CPM (баннеры)
UTM_SOURSE Рекламная система string Yandex-Direct, Google-Adwords и другие.
UTM_TERM Условие поиска кампании string Например, ключевые слова контекстной рекламы.
WEB URL ресурсов контакта crm_multifield Множественное
Поле Описание Тип Примечание
ADDRESS Адрес контакта string
ADDRESS_2 Вторая страница адреса string В некоторых странах принято разбивать адрес на 2 части
ADDRESS_CITY Город string
ADDRESS_COUNTRY Страна string
ADDRESS_COUNTRY_CODE Код страны string
ADDRESS_LEGAL string
ADDRESS_POSTAL_CODE Почтовый индекс string
ADDRESS_PROVINCE Область string
ADDRESS_REGION Район string
ASSIGNED_BY_ID Связано с пользователем по ID user
BANKING_DETAILS Банковские реквизиты string
COMMENTS Комментарии string
COMPANY_TYPE Тип компании crm_status
CREATED_BY_ID Кем создана user Только для чтения
CURRENCY_ID Валюта crm_currency
DATE_CREATE Дата создания datetime Только для чтения
DATE_MODIFY Дата изменения datetime Только для чтения
EMAIL Адрес электронной почты crm_multifield Множественное
EMPLOYESS Количество сотрудников crm_status
HAS_EMAIL Проверка заполненности поля электронной почты char Только для чтения
HAS_PHONE Проверка заполненности поля телефон char Только для чтения
ID Идентификатор контакта integer Только для чтения
IM Мессенджеры crm_multifield Множественное
INDUSTRY Сфера деятельности crm_status
IS_MY_COMPANY char
LEAD_ID Идентификатор лида, связанного с контактом crm_lead Только для чтения
LOGO Логотип file
MODIFY_BY_ID Идентификатор автора последнего изменения user Только для чтения
OPENED Доступен для всех char
ORIGINATOR_ID Идентификатор источника данных string Используется только для привязки к внешнему источнику.
ORIGIN_ID Идентификатор элемента в источнике данных string Используется только для привязки к внешнему источнику.
ORIGIN_VERSION Оригинальная версия string Используется для защиты данных от случайного перетирания внешней системой. Если данные были импортированы и не изменялись во внешней системе, то такие данные могут быть редактированы в CRM без опасения, что следующая выгрузка приведет к перетиранию данных
PHONE Телефон контакта crm_multifield Множественное
REG_ADDRESS Юридический адрес контакта string Устарел, использутся для совместимости.
REG_ADDRESS_2 Вторая страница юридического адреса string В некоторых странах принято разбивать адрес на 2 части. Устарел, использутся для совместимости.
REG_ADDRESS_CITY Город юридического адреса string Устарел, использутся для совместимости.
REG_ADDRESS_COUNTRY Страна юридического адреса string Устарел, использутся для совместимости.
REG_ADDRESS_COUNTRY_CODE Код страны юридического адреса string Устарел, использутся для совместимости.
REG_ADDRESS_LEGAL string Устарел, использутся для совместимости.
REG_ADDRESS_POSTAL_CODE Почтовый индекс юридического адреса string Устарел, использутся для совместимости.
REG_ADDRESS_PROVINCE Область юридического адреса string Устарел, использутся для совместимости.
REG_ADDRESS_REGION Район юридического адреса string Устарел, использутся для совместимости.
REVENUE Годовой оборот double
TITLE Название string Обязательное
UTM_CAMPAIGN Обозначение рекламной кампании string
UTM_CONTENT Содержание кампании string Например, для контекстных объявлений.
UTM_MEDIUM Тип трафика string CPC (объявления), CPM (баннеры)
UTM_SOURCE Рекламная система string Yandex-Direct, Google-Adwords и другие.
UTM_TERM Условие поиска кампании string Например, ключевые слова контекстной рекламы.
WEB URL ресурсов контакта crm_multifield Множественное

Внимание! Для создания Лида данного типа достаточно заполненного поля TITLE


UTM метки

Для создания UTM меток существуют скрытые поля Contact form 7:

[hidden utm_source "utm_source"]
[hidden utm_medium "utm_medium"]
[hidden utm_campaign "utm_medium"]
[hidden utm_content "utm_medium"]
[hidden utm_term "utm_medium"]

Для передачи данных из строки браузера в форму необходимо добавить скрытые поля Contact form 7 имеющие следующую конструкцию:

[hidden utm_source default:get]
[hidden utm_medium default:get]
[hidden utm_campaign default:get]
[hidden utm_content default:get]
[hidden utm_term default:get]

После сохранения формы, в Bitrix24 необходимо выставить UTM метки в соответствии с назначением.

Отзывы

  1. Макс

    работает ли ваш плагин с веткой 5.4

    • kowalski-admin

      Добрый день. Да, плагин работает с данной версией WordPress. Перед глобальными обновлениями ядра мы проверяем весь функционал плагина на работоспособность и поддерживаем его в актуальном состоянии.

  2. Mathis

    Здравствуйте, возможно ли связать одно из полей формы с персонализированным полем, которое я создал на bitrix24 для моих потенциальных клиентов?

    • kowalski-admin

      Здравствуйте. В настройках плагина не представляется возможным передавать персонализированные поля в Bitrix24, потому как эти поля у каждого свои и предугадать их невозможно.

  3. Владислав

    может ли плагин автоматически отправлять в срм поле «страна», без того, чтобы создавать такое специальное поле в форме сбора контактов?

    • Администратор сайта

      Если у вас на сайте реализован механизм определения геолокации, то можно настроить отправку данного значения в скрытое поле CF7 и передавать это значение в Битрикс24.

  4. Сергей

    Добрый день!
    После установки, подключения и настройки плагина с его внедрением в формы на Contact Form 7 в соответствии с вашей инструкцией, плагин после отправки данных формы моментально не отправляет в Битрикс24 в качестве лида. Но не могу разобраться в том, как полноценно реализовать перехват данных для каждого типа лида. Существует ли API у самого плагина, чтобы в зависимости от типа лида пепехватывать данные формы с использованием PHP-кода?

    • Администратор сайта

      Добрый день. Напишите пожалуйста свой контакт для связи в телеграм на почту — info@kowalski.su. Мы зададим пару дополнительных вопросов и поможем разобраться в ситуации.

  5. Сергей

    Добрый день!
    Почему во вкладке «Bitrix 24 Лиды» из последней версии вашего плагина в редакторе форм Contact Form 7 убрали возможность настройки и распределения типов лидов в зависимости от элементов формы? Если нет такой же возможности, как быть(из-за этого данные форм не отправляются в Битрикс24 в качестве лида) с решением таких задач?

    • Администратор сайта

      Необходимо обновить WordPress и плагин Contact Form 7 до последней версии. Нарушения в работе нашего плагина могут быть вызваны версией WordPress 4.4, Contact Form 7 4.3 и ниже.

  6. Максим

    Подскажите отдается ли название CRM формы в битрикс при заполнении? чтобы в битриксе увидеть и понимать какую именно форму заполнили?

    • Администратор сайта

      Да, можно. Необходимо сделать скрытое поле в самой форме: [hidden TITLE ‘Название формы’] и выбрать его в качестве передаваемого значения заголовка в настройках плагина на вкладке «Bitrix24 Лиды».

  7. Максим

    подскажите для интеграции с битрикс, требуется пробросить один вебхук один раз верно?

  8. Максим

    подскажите для интеграции с битрикс, требуется пробросить один вебхук один раз верно?
    если на сайте 10 форм, то данные со всех поступят в битрикс?

  9. Максим

    Подскажите у меня уже должен быть установлен плагин Integration of CF7 and Bitrix24 или я могу установить этот плагин на чистый WP ?

    • Администратор сайта

      У вас должен быть рабочий сайт на wp и установленный на нем плагин contact form 7. После чего приобретаете наш плагин и активируете его. И далее по инструкции… Если у вас ещё есть вопросы просьба написать свой контакт в телеграм на ящик info@kowalski.su для оперативного общения. Мы все подробно расскажем.

  10. Макс

    есть ли у вас плагин по интеграции с Ninja Forms

    • Администратор сайта

      В данный момент нет. Но мы можем его вам сделать индивидуально. Дайте знать если это актуально.

  11. Иван

    Добрый день. Работает ваш плагин с коробочной версией Битрикс 24 CRM?
    CRM установлена на сервере нашего предприятия.

    • Администратор сайта

      Добрый день. Да, работает. Настраивается как обычно. Видео-инструкция размещена на этой странице. Единственно надо указать host, на котором размещен ваш Битрикс24.

  12. Даниил

    Добрый день. Если я владею двумя сайтами с WP, которые мне нужно связать с Б24 мне нужно покупать соответствующее количество лицензий или достаточно одной?

    • Администратор сайта

      Добрый день. Один сайт = одна лицензия. Соответственно вам необходимо приобрести 2 лицензии.

  13. Таисия

    Добрый день!
    А как долго ждать плагин после оплаты заказа?

    • Администратор сайта

      Добрый день, Таисия. Ссылка на скачивание плагина приходит сразу же после оплаты. Если вы не увидели письма, проверьте пожалуйста папку «Спам», такое иногда случается.

Добавить отзыв

Ваш адрес email не будет опубликован. Обязательные поля помечены *