Интеграции
Битрикс24 и сайт на 1С-Битрикс
Сделка закрылась или заказ оплачен — Evidra сама просит клиента оставить отзыв по сценарию каскада (письмо, затем SMS). Ниже три способа подключить Битрикс24 без программиста и модуль для сайта.
Какой способ выбрать
| Способ | Кому подходит | Что нужно |
|---|---|---|
| Приложение из Битрикс24 Маркет | Всем: ставится в два клика, события и робот появляются сами. | Права администратора портала и код из кабинета Evidra. |
| Вебхуки | Если приложение ещё не появилось в вашем Маркете или у вас коробочный Битрикс24. | Создать входящий и исходящий вебхук в разделе «Разработчикам» портала — 5 минут. |
| Универсальный триггер | Робот «Вебхук» в автоматизации, сайт на 1С-Битрикс, Zapier/Albato, своя CRM. | Секретный URL из кабинета; телефон и email клиента — в параметрах запроса. |
Все три способа настраиваются в кабинете: Разработчикам → Интеграции. Для каждого подключения вы выбираете точку (на её площадки поведёт запрос отзыва) и сценарий каскада.
Способ 1. Приложение из Битрикс24 Маркет
- В своём Битрикс24 откройте Маркет, найдите «Evidra — запрос отзывов» и нажмите Установить. Согласитесь с запрошенными правами (CRM, бизнес-процессы, пользователи).
- В кабинете Evidra: Разработчикам → Интеграции → Битрикс24 — приложение. Выберите точку и сценарий, нажмите Получить код. Код действует 30 минут.
- Откройте установленное приложение на портале (Приложения → Evidra) и введите код. Портал привязан к вашей организации.
После привязки приложение делает две вещи:
- Слушает сделки. Когда сделка переходит в успешную стадию («сделка выиграна»), клиент из карточки сделки получает запрос отзыва. В правилах подключения можно выбрать конкретные стадии — в том числе из дополнительных направлений.
- Добавляет робота «Evidra: попросить отзыв». Он доступен в автоматизации сделок, лидов и контактов: поставьте его на любую стадию, в параметрах укажите телефон и email из полей CRM.
Способ 2. Вебхуки без установки приложения
- На портале: Разработчикам → Другое → Входящий вебхук. Отметьте права
crmиuser, сохраните и скопируйте URL видаhttps://портал.bitrix24.ru/rest/1/xxxxxxxx/. - В кабинете Evidra: Интеграции → Битрикс24 — вебхуки, вставьте URL, выберите точку и сценарий, нажмите Подключить. Мы сразу проверим доступ.
- Скопируйте из карточки подключения URL обработчика. На портале: Разработчикам → Другое → Исходящий вебхук, событие
ONCRMDEALUPDATE, в поле «URL вашего обработчика» вставьте наш адрес. - Токен приложения из настроек исходящего вебхука добавьте в подключение (кнопка «Правила запуска») — так мы будем отбрасывать запросы не от вашего портала.
Дальше всё как у приложения: смена стадии → чтение контакта по входящему вебхуку → каскад. Робота в этом режиме нет, но в карточке подключения есть дополнительный URL для стандартного робота «Вебхук».
Способ 3. Универсальный триггер
Секретный URL, на который любая система отправляет данные клиента. Авторизация — сам URL, заголовки не нужны, поэтому работает даже из конструкторов без настройки заголовков.
curl -X POST "https://evidra.ru/api/integrations/trigger/<секрет>" \
-H "Content-Type: application/json" \
-d '{"phone":"79001234567","email":"client@example.com","name":"Анна","externalId":"order-1024"}'| Поле | Обязательное | Назначение |
|---|---|---|
phone | телефон или email | Номер в любом формате: 8 900…, +7 (900)…, 7900… |
email | телефон или email | Адрес клиента |
name | нет | Имя для обращения в сообщении |
externalId | нет, но рекомендуем | Номер заказа или сделки — повторный запрос с тем же значением не запустит второй каскад |
Поля можно передать и как application/x-www-form-urlencoded, и в query-строке, и вложенными (properties[phone], data[FIELDS][PHONE]) — так шлёт робот «Вебхук» в Битрикс24. Ответ: {"ok":true,"status":"started","campaignId":"…"} или {"ok":true,"status":"skipped","reason":"…"}.
Робот «Вебхук» в Битрикс24: Автоматизация → добавить робота «Вебхук» → в URL вставьте адрес триггера, в параметры добавьте phone = телефон контакта, email = email контакта, externalId = ID сделки.
Сайт на 1С-Битрикс: модуль «Evidra: отзывы»
Модуль для «1С-Битрикс: Управление сайтом» решает две задачи: показывает отзывы с площадок на сайте и отправляет покупателя в каскад после оплаты заказа в интернет-магазине.
- Скачайте архив модуля и загрузите его в административной части сайта: Marketplace → Установленные решения → Загрузить решение (или распакуйте в
/bitrix/modules/evidra.widget/). Затем нажмите «Установить». - Настройки → Настройки модулей → Evidra: отзывы. Вставьте токен виджета (кабинет Evidra → Мои точки → точка → «Виджет»). Включите «бейдж на всех страницах», если хотите компактный блок с рейтингом внизу каждой страницы.
- Чтобы вывести витрину отзывов в нужном месте, добавьте компонент
evidra:reviewsв шаблон или на страницу через визуальный редактор (раздел «Evidra»):template.php<?$APPLICATION->IncludeComponent("evidra:reviews", ".default", [ "TOKEN" => "", // пусто — из настроек модуля "LAYOUT" => "grid", // grid | carousel | badge ]);?> - Для запроса отзыва после оплаты создайте в кабинете Универсальный триггер (способ 3) и вставьте его URL в настройки модуля, включите «Отправлять покупателя в каскад после оплаты заказа». Модуль подписан на событие
OnSaleOrderPaid: телефон, email и имя берутся из свойств заказа, номер заказа передаётся какexternalId.
Журнал и отладка
У каждого подключения в кабинете есть журнал последних событий: что пришло (номер сделки или заказа), что сделали — «каскад запущен» со ссылкой на рассылку, «пропущено» с причиной или «ошибка». Кнопка Проверить делает тестовый вызов в портал и показывает, от чьего имени работает подключение.
Стоимость SMS резервируется на балансе кабинета в момент запуска каскада. Если средств не хватает — каскад не запускается, в журнале будет причина, а в кабинете — предложение пополнить баланс. Письма входят в лимит тарифа и не тарифицируются.
