Интеграция Unisender Go и Битрикс24: передача статуса отправленного письма из Unisender Go в статус сделки Битрик24

Unisender Go — это встраиваемый сервис email-транспорта, предназначенный для отправки маркетинговых и транзакционных email-рассылок. В Пинкит есть готовая интеграция между Unisender и различными веб-сервисами, но недавно мы получили запрос на интеграцию Unisender Go с Битрикс24. Заказчик хотел получать статусы отправленных писем в его CRM, чтобы видеть реакцию контактов на рассылки. Давайте разберем, как добавить такую связку и какую бизнес-пользу можно получить от интеграции между Unisender Go и Битрикс24.

Наш заказчик для ведения сделок использует CRM Битрикс24. Платформу Unisender Go он использует для триггерных рассылок по своим контактам. Письма-уведомления отправляются в ответ на действия пользователей, например, регистрацию на сайте или добавление товаров в корзину.

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

Вручную переносить статус по каждому письму просто не реально, тем более, что выгружать статусы необходимо сразу после их изменения. Так как сервис Unisender Go изначально адаптирован под настройку с помощью API, мы добавили в Пинкит авторизацию для него (без разработки с помощью Пинкитбилдер). Также добавили событие на шаге 1 и настроили интеграцию для передачи статусов в стадии сделок Битрикс24.

1.1. Логика работы интеграции

Вкратце это работает так: есть сделка с контактом в нужном направлении (например, он добавил товары в корзину, но не закончил оформление заказа). В ответ на это действие запускается рассылка, и необходимо перевести сделку на стадию "Письмо прочитано" при изменении статуса письма в Unisender Go на "Прочитанное". Вручную ничего выполнять не нужно, интеграция отрабатывает автоматически. Разработка при настройке связки не требуется. Интеграция должна работать как для контактов, так и для компаний.

Далее расскажем, как добавить нужное событие через Пинкитбилдер и настроить такую интеграцию в личном кабинете Пинкит.

2.1. Авторизация

Чтобы добавить в Пинкит доступы к Unisender Go, необходимо зайти в раздел Пинкитбилдер "Настройки сервиса" - "Доступ".

Далее заполняем поля:

На текущий момент ключ API можно получить здесь: https://go1.unisender.ru/ru/settings/security/api.

2.2. Добавление события на шаге 1

Событие добавляется в разделе Настройки сервиса - События.

Заполняем поля:

Далее можем переходить к настройке интеграции в личном кабинете Пинкит.

3.1. Шаг 1: Откуда

Заполняем настройки:

3.2. Шаг 2: Инструменты

Используем API-запрос методом GET с указанным URL
/crm.contact.list?filter[EMAIL]={{source.events.0.event_data.email}}.

Используем инструмент Если-Иначе по полю step1.result. Условие - Пустое значение. Результат при успешной проверке = 1, Результат при неуспешной проверке = 0.

Используем API-запрос методом GET с указанным URL /crm.company.list?filter[EMAIL]={{source.events.0.event_data.email}}.

Используем инструмент Если-Иначе по полю step3.result. Условие - Пустое значение. Результат при успешной проверке = 1, Результат при неуспешной проверке = 0.

Используем инструмент Проверка. Проверять будем два поля, поэтому в Название поля укажем step2&&step4. Условие - (Логическое)Истина, Действие - Прервать, если проверка пройдена.

Используем инструмент Если-Иначе по полю step2. Условие - (Число)Равно. Результат при успешной проверке = /crm.deal.list?filter[CATEGORY_ID]=1&filter[CONTACT_ID]={{step1.result.0.ID|default()}}, Результат при неуспешной проверке = /crm.deal.list?filter[CATEGORY_ID]=1&filter[COMPANY_ID]={{step3.result.0.ID|default()}}.

Используем API-запрос методом GET с указанным URL {{step6}}.

Используем инструмент Проверка по полю step7.result. Условие - Пустое значение, Действие - Прервать, если проверка пройдена.

3.3. Шаг 3: Куда

3.4. Шаг 4: Сопоставление данных

Сопоставляем следующие данные:

3.5. Шаг 5: Запуск

Указываем Название интеграции и запускаем.

Резюмируем, как работает интеграция между Unisender Go и Битрикс24.

4.1. Когда письмо прочитано, то меняется статус письма в Unisender Go. Пинкит получает измененный статус и ищет в Битрикс24 контакт/компанию по Email. Если не находит, то интеграция пропускает их.

4.2. Если контакт или компания найдены, то Пинкит переходит к поиску открытой сделки в заданном направлении с нужным ID. Если сделок нет, тогда работа интеграции прерывается.

4.3. Если сделка была найдена, то интеграция сменит стадию сделки в Битрикс24 на стадию, соответствующую статусу письма.

#unisender_go#пинкит_unisendergo_битрикс24