Передача лидов из Opencart 2 в Bitrix24 (актуально на октябрь 2020)
Собрал, актуализировал и доработал информацию по передаче Заказов из Opencart 2 в Bitrix24. Работает по средствам входящих вебхуков.
Что умеет делать данная интеграция
0) Может работать с Ajax Quick Checkout
1) Создает Лид из заказа с сайта.
2) В лид передаются все поля из заказа:
- Имя
- Фамилия
- Телефон
- Почта
- Название компании
- Источник (адрес сайта)
- Город (адрес)
- Улица (адрес)
- Заказанные товары с опциями (в комментарий)
- Сумма заказа
- Способ доставки (в комментарий)
- Способ оплаты (в комментарий)
- Комментарий к заказу (в комментарий)
- UTM метки
Создаем входящий вебхук
Переходим по Ваш Битрикс24 => Приложения => Разработчикам => Интегрировать с внешними системами => Добавить лиды
Либо сразу по короткой ссылке https://[ВашБитрикс].bitrix24.ru/devops/section/external/
- Даем название вебхуку
- Копируем код вебхука (между двумя последними слешами)
- Можно удалить лишние параметры (ни на что не влияют)
- Сохраняем.
Узнаем ID ответственного
Кого назначить ответственным, решаем самостоятельно. Сам ID - порядковый номер сотрудника, можно посмотреть в Битрикс24 в разделе Сотрудники => Сотрудники, и наведя мышкой, либо кликнув по нужному сотруднику.
https://[ВашБитрикс].bitrix24.ru/company/personal/user/1/
Установка и настройка OCMOD
Скачиваем bitrix24.ocmod.zip. Загружаем в Opencart через Дополнения - Установка дополнений. Обновляем кеш Модификаторов.
upd. ссылка временно убрана
Переходим в Система - Настройки - Редактировать магазин - Bitrix24.
Указываем ID ответственного, вставляем вебхук, заполняем название аккаунта Битрикс24. Сохраняем.
Создаем заказ и проверяем что приходит лид
Справочно. Все параметры для передачи в лид
Все параметры для передачи данных в лиды CRM
| Поле | Описание | Тип |
|---|---|---|
| ADDRESS | Адрес контакта | string |
| ADDRESS_2 | Вторая страница адреса | string |
| 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 |
| Адрес электронной почты | 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 |
| 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 | |
| TITLE | Название лида | string |
| UTM_CAMPAIGN | Обозначение рекламной кампании | string |
| UTM_CONTENT | Содержание кампании | string |
| UTM_MEDIUM | Тип трафика | string |
| UTM_SOURCE | Рекламная система | string |
| UTM_TERM | Условие поиска кампании | string |
| WEB | URL ресурсов лида | crm_multifield |
| ПАРАМЕТР | ТИП | ОПИСАНИЕ | ПРИМЕЧАНИЕ |
|---|---|---|---|
| LOGIN | String | Логин | Обязательное поле только при использовании упрощенного Rest API |
| PASSWORD | String | Пароль | Обязательное поле только при использовании упрощенного Rest API |
| TITLE | String | Заголовок лида | Обязательное поле |
| HONORIFIC | String | Тип обращения к клиенту | |
| NAME | String | Имя клиента | |
| LAST_NAME | String | Фамилия клиента | |
| SECOND_NAME | String | Отчество клиента | |
| BIRTHDATE | date | Дата рождения клиента | |
| 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 | Район клиента | |
| COMPANY_ID | crm_company | Привязка лида к компании | Только для чтения |
| COMPANY_TITLE | crm_company | Название компании, привязанной к лиду | |
| CONTACT_ID | crm_company | Привязка лида к контакту | Только для чтения |
| POST | String | Должность клиента | |
| COMMENTS | String | Комментарий клиента | |
| SOURCE_DESCRIPTION | String | Дополнительно о статусе | |
| STATUS_DESCRIPTION | String | Дополнительно об источнике | |
| OPPORTUNITY | Double | Возможная сумма сделки | |
| CURRENCY_ID | String | Валюта | |
| PRODUCT_ID | String | Продукт | |
| SOURCE_ID | String | Источник | |
| STATUS_ID | String | Статус | |
| ASSIGNED_BY_ID | user | Ответственный за клиента | |
| PHONE_WORK | String | Рабочий телефон | |
| PHONE_MOBILE | String | Мобильный телефон | |
| PHONE_FAX | String | Номер факса | |
| PHONE_HOME | String | Домашний телефон | |
| PHONE_PAGER | String | Номер пейджера | |
| PHONE_OTHER | String | Другой телефон | |
| WEB_WORK | String | Корпоративный сайт | |
| WEB_HOME | String | Личная страница | |
| WEB_FACEBOOK | String | Страница Facebook | |
| WEB_LIVEJOURNAL | String | Страница LiveJournal | |
| WEB_TWITTER | String | Микроблог Twitter | |
| WEB_OTHER | String | Другой сайт | |
| EMAIL_WORK | String | Рабочий e-mail | |
| EMAIL_HOME | String | Частный e-mail | |
| EMAIL_OTHER | String | Другой e-mail | |
| M_SKYPE | String | Контакт Skype | |
| IM_ICQ | String | Контакт ICQ | |
| IM_MSN | String | Контакт MSN/Live! | |
| IM_JABBER | String | Контакт Jabber | |
| IM_OTHER | String | Другой контакт | |
| UTM_CAMPAIGN | String | Обозначение рекламной кампании | |
| UTM_CONTENT | String | Содержание кампании | |
| UTM_MEDIUM | String | Тип трафика | |
| UTM_SOURCE | String | Рекламная система | |
| UTM_TERM | String | Ключевое слова/условия поиска |
Таблица 2: STATUS_ID – Статусы для лидов
| ЗНАЧЕНИЕ | НАЗВАНИЕ |
|---|---|
| NEW | Не обработан |
| ASSIGNED | Назначен ответственный |
| DETAILS | Уточнение информации |
| CANNOT_CONTACT | Не удалось связаться |
| IN_PROCESS | В обработке |
| ON_HOLD | Обработка приостановлена |
| RESTORED | Сконвертирован |
| CONVERTED | Восстановлен |
| JUNK | Некачественный лид |
Таблица 3: SOURCE_ID – Источники
| ЗНАЧЕНИЕ | НАЗВАНИЕ |
|---|---|
| SELF | Свой контакт |
| PARTNER | Существующий клиент |
| CALL | Звонок |
| WEB | Веб-сайт |
| Электронная почта | |
| CONFERENCE | Конференция |
| TRADE_SHOW | Выставка |
| EMPLOYEE | Сотрудник |
| COMPANY | Кампания |
| HR | HR — департамент |
| Письмо | |
| OTHER | Другое |
Таблица 4: PRODUCT_ID – Продукты
| ЗНАЧЕНИЕ | НАЗВАНИЕ |
|---|---|
| PRODUCT_1 | 1С-Битрикс: Управление сайтом |
| PRODUCT_2 | 1С-Битрикс: Корпоративный портал |
| OTHER | Другое |
Таблица 5: CURRENCY_ID – Валюты
| ЗНАЧЕНИЕ | НАЗВАНИЕ |
|---|---|
| RUB | Рубль |
| USD | Доллар США |
| EUR | Евро |
20.10.2020
(1263 просмотров)