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

Приложение настраивается в кабинете: Разработчикам → Интеграции. Ключ API — на вкладке «Ключи API». Для подключения выбираете локацию: на её площадки поведёт запрос отзыва.

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

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

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

Секретный 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"}'

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

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.

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

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