Skip to end of metadata
Go to start of metadata

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

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

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

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

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

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

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

В настройках сделки нужно добавить дополнительное текстовое поле roistat. Для этого в amoCRM откройте Настройки → Поля:

 Добавление доп. поля в amoCRM до редизайна

Зайдите в amoCRM в любую сделку. Добавьте текстовое поле и назовите его roistat.

Шаг 3. Подключите amoCRM в каталоге интеграций

  1. Откройте Каталог интеграций.
  2. В блоке CRM / CMS выберите amoCRM и нажмите кнопку Подключить.
  3. Заполните поля для авторизации в amoCRM:
    1. В поле Адрес введите URL-адрес вашего проекта в amoCRM. Обычно он выглядит так: https://<название проекта>.amocrm.ru.
    2. В поле Логин введите адрес электронной почты для авторизации в amoCRM.
    3. В поле API-ключ введите API-ключ. Для этого скопируйте его разделе amoCRM Настройки → API:


       Получение API ключа в amoCRM до редизайна

      Зайдите в профиль пользователя и скопируйте значение из раздела Ключ для авторизации в API.

  4. Нажмите кнопку Сохранить.
    Откроется блок Дополнительные настройки и загрузятся статусы сделок из amoCRM.
  5. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей. 
  6. В поле Ответственные за сделки введите через запятую ID менеджеров. С помощью этого списка Roistat автоматически распределяет сделки по указанным менеджерам.

     Как узнать ID менеджера
    1. Перейдите на страницу API-консоли amoCRM.
    2. В раскрывающемся списке Authentication выберите Custom Token:

      Откроется окно Custom Token.
    3. В поле под USER_LOGIN  введите логин администратора в amoCRM.
    4. В поле под USER_HASH введите API-ключ amoCRM.
    5. Нажмите кнопку OK.
    6. В меню слева пройдите по ссылке account/current:
    7. В открывшемся окне в поле Request URL замените {subdomain} на поддомен вашей CRM.
    8. В поле Parameter введите users.
    9. Нажмите кнопку Send.
      В правой части окна в столбце Response появится ответ. В информации по users выводится массив со списком пользователей CRM. Идентификатор пользователя указан в строке id. Например: "id": "650253":
             


  7. В раскрывающемся списке Создавать лиды в выберите один из вариантов:

    •  Сделки. На основе данных, переданных с сайта, будут создаваться сделки.
    • Неразобранное. На основе заявок с сайта в amoCRM будут создаваться сделки со статусом Неразобранное . Требуется также выполнить следующие действия:
      1.  В amoCRM подключите форму, даже если вы не будете размещать ее на сайте. Это необходимо из-за особенностей реализации передачи заявок в CRM через Roistat.

      2. В настройках интеграции с amoCRM в поле Идентификатор формы введите идентификатор формы, подключенной в amoCRM.

         Как узнать идентификатор формы в amoCRM
        1. В проекте amoCRM откройте раздел Сделки.
        2. В правом верхнем углу нажмите на иконку шестеренки. 
        3. Пройдите по ссылке Форма, чтобы открыть ее настройки.

        4. Перейдите на закладку Размещение формы.
        5. В коде формы для размещения на сайте скопируйте ID формы:

        (warning) После изменения статуса заявки в amoCRM с Неразобранное на Воронка в amoCRM создается сделка с новым контактом, даже если уже существует клиент с указанными контактными данными. Это не ошибка, а особенность работы с этой сущностью, предусмотренная разработчиками amoCRM. Пока сделка имеет статус Неразобранное в amoCRM, она не загружается в Roistat. 

  8. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.
  9. Нажмите кнопку Сохранить.
  10. Перетаскивая статусы сделок, распределите их по группам. Подробнее читайте в статье Распределение статусов сделок.

(info) У учетной записи, которую вы указываете для настройки интеграции amoCRM с Roistat, должны быть права на создание сделок.

(warning)  После изменения адреса электронной почты или пароля учетной записи amoCRM меняется API-ключ amoCRM. Это приводит к нарушению интеграции amoCRM c Roistat. Для ее восстановления обновите API-ключ amoCRM в настройках интеграции.

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

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

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

Вы можете также настроить передачу сделок в CRM через Roistat - механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM.

Подробнее читайте в статье Передача заявок в CRM через Roistat.

Проверка работы 

После того, как на сайте отправлена заявка, в amoCRM создается новая сделка с заполненным полем roistat. Сделки также отображаются и в Roistat: 

  1. В проекте Roistat откройте Каталог интеграций.
  2. В блоке Сейчас подключено на виджете настроенной интеграции с amoCRM нажмите кнопку Настроить.
  3. В окне настройки интеграции пройдите по ссылке Список отправленных заявок.

(warning) Создавать сделки в amoCRM Roistat может только в том случае, если CRM оплачена, либо активен тестовый тариф. В ином случае сделки не создаются.

 

  • No labels