Интеграции

Битрикс24 и сайт на 1С-Битрикс

Сделка закрылась или заказ оплачен — Evidra сама просит клиента оставить отзыв по сценарию каскада (письмо, затем SMS). Ниже три способа подключить Битрикс24 без программиста и модуль для сайта.

Какой способ выбрать

СпособКому подходитЧто нужно
Приложение из Битрикс24 МаркетВсем: ставится в два клика, события и робот появляются сами.Права администратора портала и код из кабинета Evidra.
ВебхукиЕсли приложение ещё не появилось в вашем Маркете или у вас коробочный Битрикс24.Создать входящий и исходящий вебхук в разделе «Разработчикам» портала — 5 минут.
Универсальный триггерРобот «Вебхук» в автоматизации, сайт на 1С-Битрикс, Zapier/Albato, своя CRM.Секретный URL из кабинета; телефон и email клиента — в параметрах запроса.

Все три способа настраиваются в кабинете: Разработчикам → Интеграции. Для каждого подключения вы выбираете точку (на её площадки поведёт запрос отзыва) и сценарий каскада.

Способ 1. Приложение из Битрикс24 Маркет

  1. В своём Битрикс24 откройте Маркет, найдите «Evidra — запрос отзывов» и нажмите Установить. Согласитесь с запрошенными правами (CRM, бизнес-процессы, пользователи).
  2. В кабинете Evidra: Разработчикам → Интеграции → Битрикс24 — приложение. Выберите точку и сценарий, нажмите Получить код. Код действует 30 минут.
  3. Откройте установленное приложение на портале (Приложения → Evidra) и введите код. Портал привязан к вашей организации.

После привязки приложение делает две вещи:

  • Слушает сделки. Когда сделка переходит в успешную стадию («сделка выиграна»), клиент из карточки сделки получает запрос отзыва. В правилах подключения можно выбрать конкретные стадии — в том числе из дополнительных направлений.
  • Добавляет робота «Evidra: попросить отзыв». Он доступен в автоматизации сделок, лидов и контактов: поставьте его на любую стадию, в параметрах укажите телефон и email из полей CRM.
Повторный запуск по той же сделке не происходит: мы запоминаем номер сделки. Если у контакта нет ни телефона, ни email — событие попадёт в журнал подключения как «пропущено» с причиной.

Способ 2. Вебхуки без установки приложения

  1. На портале: Разработчикам → Другое → Входящий вебхук. Отметьте права crm и user, сохраните и скопируйте URL вида https://портал.bitrix24.ru/rest/1/xxxxxxxx/.
  2. В кабинете Evidra: Интеграции → Битрикс24 — вебхуки, вставьте URL, выберите точку и сценарий, нажмите Подключить. Мы сразу проверим доступ.
  3. Скопируйте из карточки подключения URL обработчика. На портале: Разработчикам → Другое → Исходящий вебхук, событие ONCRMDEALUPDATE, в поле «URL вашего обработчика» вставьте наш адрес.
  4. Токен приложения из настроек исходящего вебхука добавьте в подключение (кнопка «Правила запуска») — так мы будем отбрасывать запросы не от вашего портала.

Дальше всё как у приложения: смена стадии → чтение контакта по входящему вебхуку → каскад. Робота в этом режиме нет, но в карточке подключения есть дополнительный URL для стандартного робота «Вебхук».

Способ 3. Универсальный триггер

Секретный URL, на который любая система отправляет данные клиента. Авторизация — сам URL, заголовки не нужны, поэтому работает даже из конструкторов без настройки заголовков.

POST или GET
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С-Битрикс: Управление сайтом» решает две задачи: показывает отзывы с площадок на сайте и отправляет покупателя в каскад после оплаты заказа в интернет-магазине.

  1. Скачайте архив модуля и загрузите его в административной части сайта: Marketplace → Установленные решения → Загрузить решение (или распакуйте в /bitrix/modules/evidra.widget/). Затем нажмите «Установить».
  2. Настройки → Настройки модулей → Evidra: отзывы. Вставьте токен виджета (кабинет Evidra → Мои точки → точка → «Виджет»). Включите «бейдж на всех страницах», если хотите компактный блок с рейтингом внизу каждой страницы.
  3. Чтобы вывести витрину отзывов в нужном месте, добавьте компонент evidra:reviews в шаблон или на страницу через визуальный редактор (раздел «Evidra»):
    template.php
    <?$APPLICATION->IncludeComponent("evidra:reviews", ".default", [
        "TOKEN"  => "",        // пусто — из настроек модуля
        "LAYOUT" => "grid",    // grid | carousel | badge
    ]);?>
  4. Для запроса отзыва после оплаты создайте в кабинете Универсальный триггер (способ 3) и вставьте его URL в настройки модуля, включите «Отправлять покупателя в каскад после оплаты заказа». Модуль подписан на событие OnSaleOrderPaid: телефон, email и имя берутся из свойств заказа, номер заказа передаётся как externalId.
Модуль ничего не хранит и не замедляет сайт: отзывы загружает браузер посетителя с сервера Evidra, а запрос в триггер уходит один раз при оплате с таймаутом 10 секунд и не влияет на проведение заказа.

Журнал и отладка

У каждого подключения в кабинете есть журнал последних событий: что пришло (номер сделки или заказа), что сделали — «каскад запущен» со ссылкой на рассылку, «пропущено» с причиной или «ошибка». Кнопка Проверить делает тестовый вызов в портал и показывает, от чьего имени работает подключение.

Стоимость SMS резервируется на балансе кабинета в момент запуска каскада. Если средств не хватает — каскад не запускается, в журнале будет причина, а в кабинете — предложение пополнить баланс. Письма входят в лимит тарифа и не тарифицируются.