Создаем лид в Битрикс24 через API
Введение
У Битрикс24 есть API, который позволяет делать определенные полезные штуки. Одна из них – отправка лида в CRM. Т.е. мы можем запрограммировать отправку данных из любой формы своего сайта в свой Битрикс24. Супер! Разберемся, как это сделать.
Создание вебхука
Прежде всего, в рамках Битрикс24 нужно создать вебхук, в который мы будем отправлять данные с сайта. В Битрикс24 в левом меню переходим в раздел Приложения, идем на вкладку Вебхуки, жмем кнопку Добавить вебхук, в подменю выбираем Входящий вебхук:
Открылась форма добавления вебхука. В поле Название вводим произвольное название, например Получение лидов с сайта. Поле Описание заполняем по своему желанию. В списке Права доступа отмечаем чекбокс CRM:
Больше ничего отмечать не нужно, нажимаем кнопку Сохранить (находится под списком прав доступа):
Перед нами открывается страница с кодом вебхука:
Сохраните этот код, он понадобится нам далее. Код никому не показывайте, это конфиденциальная информация.
Пример 1: передаем имя и телефон
Начнем с самого простого примера: передадим в CRM имя и номер телефона:
Комментарии добавил прямо в код, думаю вопросов быть не должно. Если запустим этот код — в Битрикс24 появится уведомление о создании нового лида:
В CRM зайдем в лид и увидим всю информацию, которую мы передали:
Супер! В примере мы заполнили только Название лида, Имя и Номер телефона. Но в CRM Б24 доступно намного больше полей. Их список можно посмотреть в документации по ссылке: https://dev.1c-bitrix.ru/rest_help/crm/leads/crm_lead_fields.php — обязательно ознакомьтесь с этой табличкой.
Пример 2: передаем пользовательские свойства
Немного дополним наш пример, передадим значения двух пользовательских полей. Предположим, что в CRM у нас есть поле Ждет звонка типа Да/Нет (содержит информацию о том, нужно ли перезвонить этому клиенту). И поле Дополнительное сообщение типа Строка, в котором мы передаем сообщение, оставленное пользователем:
Нам нужно получить коды этих свойств. Узнать их можно через просмотр кода элемента. Вот код нашего первого свойства:
Добавим их в наш код и получим следующее:
Как видим, пользовательские свойства передаются точно так же, как и обычные поля. Результат в CRM выглядит следующим образом:
Пользовательские поля корректно сохранились в Битрикс24.
Пример 3: передаем UTM-метки
Передача UTM-меток ничем не отличается от передачи обычных полей. Но я решил вынести этот пример в отдельный блок, т.к. в свое время сам не знал о существовании специальных полей для UTM-меток в CRM Битрикс24. А они есть, это следующие поля:
Дополним наш код исходя из этой информации: вытянем UTM-метки из урла и отправим их в лид:
Отправим лид со страницы со следующим набором значений в урле:
В итоге получим этот набор UTM-меток в соответствующих полях лида:
Пример сообщения об ошибке
У нас в коде есть блок, который отвечает за вывод ошибок, вот он:
Давайте попробуем получить какую-нибудь ошибку. Например, укажем несуществующего пользователя в переменной $b24UserID:
Запустив код с неправильным ID пользователя, мы получим следующее сообщение:
А в ячейке $result[‘error’] будет храниться код ошибки, в данном случае INVALID_CREDENTIALS.
Возможно, это поможет кому-то при дебаге.
Другие посты из этой же рубрики:
Copyright © 2015-2021, Алфавитка.ру – IT-блог разработчика.
Добавление сделки (лида, счета, компреда) с товарами, с применением скидок и налогов
Описание
Примеры создания различных сущностей с одновременным добавленем товаров к ним. Добавляемый товар берётся из Битрикс24 с ценой больше нуля. Все примеры добавляют товар в максимально возможном количестве вариаций, около каждой вариации есть мини комментарий с описанием какими дополнительными условиями будет отображаться товар.
Прикрепление товаров к сделке
Прикрепление товаров к лиду
Создание счёта с товарами
Прикрепление товаров к компред
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.
Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
В дальнейшей работе с товарами REST API Битрикс24 возвращает полезные параметры цены товарных позиций:
PRICE_EXCLUSIVE — цена без налога со скидкой
PRICE_NETTO — цена без налога и без скидки
PRICE_BRUTTO — цена с налогом без скидки
PRICE — итоговая цена позиции с налогом и со скидкой
Прикрепляя товары к сделке \ лиду описанными выше способами, хоть и, действительно, параметр итоговой цены PRICE можно не указывать (в интерфейсе он рассчитается автоматически), тем не менее, в дальнейшей работе с товарами по REST вам будут возвращать его значение, равное 0.
Поэтому лучше его, всё-таки, указывать:
Bitrix24 лиды с сайта — автоматическое создание лидов
Как добавлять в Bitrix24 лиды с сайта? Данным вопросом начинают задаваться многие, так как с каждым днем CRM Битрикс24 набирает популярность среди вебмастеров и владельцев сайтов. И у многих встает вопрос, как же организовать автоматическое создание лидов с сайта в CRM Битрикс24, если Вы не используете одноименную CMS.
Для этого давайте рассмотрим два способа:
См. также публикацию на тему:
Автоматическое создание лидов в Битрикс24 через упрощенный Rest API
Для того, чтобы организовать автоматическое создание лидов в Битрикс24 Вам необходимо:
Логин и пароль пользователя Вашей CRM
Так как логин и пароль пользователя из-под которого будут создаваться лиды указываются в скрипте, то для безопасности рекомендуется использовать отдельного пользователя с правами только на добавление лида и без доступа куда-либо еще. Данная мера необходима для безопасности Ваших данных, на тот случай, если каким-то образом PHP скрипт для отправки данных в Битрикс 24 окажется у злоумышленников.
PHP скрипт для отправки данных
В Bitrix24 лиды с сайта можно передавать PHP скриптом, который приведен ниже. При этом для автоматического создания лидов, необходимо передать 3 обязательных параметра:
все остальные параметры являются не обязательными и не подлежат обязательной передаче. Однако советую Вам передавать как можно больше данных в лиде: email, телефон, комментарий, utm метки и многое другое (см. все параметры для формирования лидов).
И умение перехватывать данные из форм
По умолчанию, обязательным параметром для заполнения является Title, значение которого будет названием для лида в Битрикс24. Все остальные параметры Вы можете передавать на свое усмотрение (см.таблицы с параметрами).
Данные параметры из «Таблица 1: Параметры для лидов», отвечают за передачу данных в стандартные поля Битрикс24. Если у Вас есть поля, которые Вы самостоятельно создали в Битрикс24, и Вам необходимо передавать для них значение с сайта вместе с лидами, то предлагаю Вам ознакомится с данной статьей.
Автоматическое создание лидов в Битрикс24 при помощи входящего вебхука
Комманда Битрикс 24 внедрила очень простой и функциональный способ интеграции с CRM системой. Если ранее интеграция с Битрикс 24 была не простой задачей, требующей отличной квалификации и знаний от вебмастеров и владельцев сайта, то теперь, с внедрением вебхуков, произвести интеграцию своего сайта с CRM системой может практически каждый желающий.
Так что такое вебхуки в Битрикс24? WebHooks Bitrix24 — механизм, который позволяет вам использовать практически весь богатый функционал Rest API Битрикс24, но при минимальных знаниях и трудозатрат.
На мой взгляд, это более безопасный способ передачи информации в CRM систему, чем при помощи упрощенного Rest API.
И так, для организации автоматической передачи лидов при помощи вебхуков необходимо:
Создать входящий вубхук
Для того, чтобы передать данные с вашей формы обратной связи в лиды Битрикс 24 необходимо создать входящий вебхук. Для этого следуем по инструкции:
Написать короткий код для перехвата и передачи данных
Для завершения организации передачи данных с формы сайта в лиды Битрикс24 при помощи вебхуков необходимо всего лишь написать коротенький код. При написание кода необходимо учесть всего 3 простых шага:
Пример кода для интеграции Битрикс24 и сайта при помощи вебхуков
Учесть особенность для передачи номера телефона, email, мессенджера
, где nX — это одно значение (телефона или электронной почты), которое всегда начинается с 0.
Таким образом, для передачи хотя бы одного телефона и адреса электронной почты, код будет иметь следующий вид:
Теперь проверьте свой Битрикс 24 и вы найдете там созданный лид =)
Сделки
| Функция | Описание |
|---|---|
| crm.deal.add | Создаёт новую сделку. |
| crm.deal.contact.add | Добавляет контакт к указанной сделке. |
| crm.deal.contact.delete | Удаляет контакт из указанной сделки. |
| crm.deal.contact.fields | Возвращает описание полей для связи сделка-контакт. |
| crm.deal.contact.items.delete | Очищает набор контактов, связанных с указанной сделкой. |
| crm.deal.contact.items.get | Возвращает набор контактов, связанных с указанной сделкой. |
| crm.deal.contact.items.set | Устанавливает набор контактов, связанных с указанной сделкой. |
| crm.deal.delete | Удаляет сделку и все связанные с ней объекты. |
| crm.deal.fields | Возвращает описание полей сделки. |
| crm.deal.get | Возвращает сделку по идентификатору. |
| crm.deal.list | Возвращает список сделок по фильтру. |
| crm.deal.productrows.get | Возвращает товарные позиции сделки. |
| crm.deal.productrows.set | Устанавливает (создаёт или обновляет) товарные позиции сделки. |
| crm.deal.recurring.add | Добавляет новую настройку для регулярной сделки. |
| crm.deal.recurring.delete | Удаляет существующую настройку для шаблона регулярной сделки. |
| crm.deal.recurring.expose | Создает новую сделку из шаблона. |
| crm.deal.recurring.fields | Возвращает список полей настройки шаблона регулярной сделки c описанием. |
| crm.deal.recurring.get | Возвращает поля настройки шаблона регулярной сделки по идентификатору. |
| crm.deal.recurring.list | Возвращает список настроек шаблонов регулярных сделок по фильтру. |
| crm.deal.recurring.update | Обновляет существующую настройку для шаблона регулярной сделки. |
| crm.deal.update | Обновляет существующую сделку. |
| crm.deal.userfield.add | Создаёт новое пользовательское поле для сделок. |
| crm.deal.userfield.get | Возвращает пользовательское поле сделок по идентификатору. |
| crm.deal.userfield.list | Возвращает список пользовательских полей сделок по фильтру. |
| crm.deal.userfield.update | Обновляет существующее пользовательское поле сделок. |
| crm.deal.userfield.delete | Удаляет пользовательское поле сделок. |
Общий список событий сделки приведен здесь.
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.
Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
Bitrix24 создание лида через API
Данные из любых форм на сайте можно отправлять в Битрикс24, для примера добавим лид в crm с сайта.
Bitrix24 создание лида через API
Данные из любых форм на сайте можно отправлять в Битрикс24, для примера добавим лид в crm с сайта.
Данные из любых форм на сайте можно отправлять в Битрикс24, для примера добавим лид в crm с сайта.
Необходимо отправить запрос на создание лида в вашу crm, примерно так:
У пользователя ($login) должны быть права на создание лида с CRM.
Все поля которые можно заполнить при добавлении:
| Параметр | Тип | Описание |
|---|---|---|
| LOGIN* | String | Логин |
| PASSWORD* | String | Пароль |
| TITLE* | String | Название |
| COMPANY_TITLE | String | Название компании |
| NAME | String | Имя |
| LAST_NAME | String | Фамилия |
| SECOND_NAME | String | Отчество |
| POST | String | Должность |
| ADDRESS | 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 | Int | Ответственный |
| 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 |
| IM_SKYPE | String | Контакт Skype |
| IM_ICQ | String | Контакт ICQ |
| IM_MSN | String | Контакт MSN/Live! |
| IM_JABBER | String | Контакт Jabber |
| IM_OTHER | String | Другой контакт |
| Значение | Название |
|---|---|
| NEW | Не обработан |
| ASSIGNED | Назначен ответственный |
| DETAILS | Уточнение информации |
| CANNOT_CONTACT | Не удалось связаться |
| IN_PROCESS | В обработке |
| ON_HOLD | Обработка приостановлена |
| RESTORED | Сконвертирован |
| CONVERTED | Восстановлен |
| JUNK | Некачественный лид |
| Значение | Название |
|---|---|
| RUB | Рубль |
| USD | Доллар США |
| EUR | Евро |
| Значение | Название |
|---|---|
| PRODUCT_1 | 1С-Битрикс: Управление сайтом |
| PRODUCT_2 | 1С-Битрикс: Корпоративный портал |
| OTHER | Другое |
Помимо основных полей, у лида могу присутствовать дополнительные пользовательские поля, созданные администратором сайта. Их вы тоже можете передать из формы.