Настраивайте интеграцию с Roistat по API, если в каталоге интеграций Roistat вы не находите вашу CRM.

Как работает интеграция

При оформлении заявки на сайте автоматически создается новая сделка в CRM, в которую передается номер визита из куки браузера roistat_visit в дополнительное поле с именем roistat. Если менеджер принимает заказ по телефону, он может спросить промокод (настраивается отдельно) и ввести этот код в поле roistat.

Настройка интеграции

Шаг 1. Установите счетчик

На каждую страницу, куда посетители переходят с рекламных каналов, нужно установить счетчик Roistat. Он необходим для получения информации о рекламном визите и работы инструментов Roistat.

О том, как установить счетчик на сайт, читайте статью Установка счетчикаЕсли на сайте уже есть счетчик, пропустите этот шаг.

Шаг 2. Добавьте дополнительное поле roistat

Добавьте в вашей CRM дополнительное текстовое поле roistat. В него Roistat будет передавать номер визита.
Пример: если пользователь зашел на ваш сайт и имеет номер визита 115, то дополнительное поле roistat будет иметь следующий вид: roistat = 115.

Шаг 3. Настройте использование API-методов для обмена информацией с Roistat

Документация по API-методам Roistat доступна по ссылке. В таблице указаны основные методы для интеграции с Roistat:

МетодНазначение метода
/project/add-orders

Передает в Roistat сделки из CRM. Roistat проверяет, есть ли в проекте сделки с такими ID. Если есть, то обновляет их, если нет, то создает.

Рекомендуем настроить загрузку в Roistat информации о сделках, созданных или измененных в CRM за последние сутки, с частотой раз в час с помощью планировщика задач Cron. С таким расписанием информация в проекте Roistat будет актуальна, даже если отдельные попытки обновить список сделок закончатся ошибкой.

/project/set-statusesЗагружает в Roistat статусы сделок из CRM или обновляет их.
/project/integration/order/{orderId}/status/updateИзменяет статус сделки.
/project/integration/order/{orderId}/deleteУдаляет сделку.

Шаг 4. Подключите Интеграцию по API в каталоге интеграций

  1. Откройте Каталог интеграций.
  2. В блоке CRM / CMS выберите Интеграция по API и нажмите кнопку Подключить.
  3. Если себестоимость загружается из стандартного поля в CRM (скорее всего, оно так и называется - Себестоимость), для Поля себестоимости выберите значение Не используется.
  4. В поле Ссылка на сделку в CRM введите URL, по которому хранятся сделки в вашей CRM. Вместо id сделки укажите в URL {order_id}. Например: http://mycrm.com/orders/{order_id}/view.
  5. В поле Ссылка на контакт в CRM введите URL, по которому хранятся контакты клиентов в вашей CRM. Вместо id контакта укажите в URL {contact_id}. Например: http://mycrm.com/contacts/{contact_id}/view.
  6. В поле Адрес обработчика заявок введите webhook-URL, на который Roistat будет отправлять информацию о звонках с сайта, проходящих через Коллтрекинг Roistat, и заявках с сайта, если вы настроите отправку заявок в CRM через Roistat. Подробнее читайте в статье Webhook для отправки заявок.
  7. В поле Адрес для получения доп. информации по сделке введите webhook-URL, на который Roistat будет отправлять дополнительную информацию по сделкам, если настроено. Подробнее читайте по ссылке.
  8. В Раскрывающемся списке Поле с датой оплаты выберите один из вариантов:
  9. Нажмите Сохранить.
    Если вы уже использовали API-метод для загрузки в Roistat статусов сделок из вашей CRM, они отобразятся в группе Не учитываются.
  10. Перетаскивая статусы сделок, распределите их по группам. Подробнее об этом читайте в статье Распределение статусов сделок.

Шаг 5. Настройте автоматическую отправку сделок в CRM