Loading...
Page tree
Skip to end of metadata
Go to start of metadata

Настраивайте интеграцию с 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 будет актуальна, даже если отдельные попытки обновить список сделок закончатся ошибкой.

В случае изменений в процессе создания и/или учета сделок и продаж (например, если в проекте были перенесены статусы в иную воронку, изменился статус у сделки, изменилась выручка продажи и иное), необходимо повторно загрузить сделки с актуальной информацией, используя метод /add-orders

/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. В Раскрывающемся списке Поле с датой оплаты выберите один из вариантов:
    • Не используется. Если выбран этот вариант, то при передаче сделки из вашей CRM в Roistat дата оплаты сделки определяется как дата перевода сделки в один из статусов группы статусов Оплачено (читайте пункт 10 инструкции).
    • Параметр paid_date. Если выбран этот вариант, настроена передача сделки из вашей CRM в Roistat с помощью API-метода /project/add-orders, и массиве дополнительных полей fields передается значение поля paid_date, то дата оплаты по сделке определяется передаваемым значением этого поля.
      Параметр paid_date работает только для новых сделок. Если вы хотите изменить дату продажи уже загруженных в Roistat сделок, воспользуйтесь Экспериментальной возможностью "Укажите название поля из которого необходимо загружать дату продажи"
      Формат даты должен быть YYYY-MM-DD HH:MM:SS или в timestamp.
  9. Нажмите Сохранить.
    Если вы уже использовали API-метод для загрузки в Roistat статусов сделок из вашей CRM, они отобразятся в группе Не учитываются.
  10. Перетаскивая статусы сделок, распределите их по группам. Подробнее об этом читайте в статье Распределение статусов сделок.

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

Рекомендуем настроить передачу сделок в CRM через Roistat - механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.

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

Пример кода, с помощью которого можно получить значение этой куки:

$roistatVisitId = array_key_exists('roistat_visit', $_COOKIE) ? $_COOKIE['roistat_visit'] : "неизвестно";


  • No labels