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

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

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

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

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

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

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

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

  1. Войдите в личный кабинет ПланФикс.
  2. Перейдите в раздел Задачи → Шаблоны задач: 
  3. Выберите из существующих или создайте новый шаблон задачи, по которому будут создаваться заявки:
     
  4. Откройте шаблон и нажмите Редактировать:
     
  5. Нажмите кнопку Новое поле:
     
    Откроется окно Добавление нового поля.
  6. В поле Название введите roistat. Значения остальных параметров установите по своему усмотрению:

  7. Нажмите Сохранить.
  8. Поле roistat появится в списке дополнительных полей. Отобразите его на одной из панелей шаблона, например Дополнительные параметры:
     
  9. Нажмите Сохранить шаблон.

Шаг 2. Подключите ПланФикс в каталоге интеграций

  1. В проекте Roistat откройте Каталог интеграций.
  2. В блоке CRM / CMS выберите planfix и нажмите кнопку Подключить.
  3. В поле Поддомен API введите apiru, если ваш проект Планфикс расположен на сервере в России,  api - если ваш проект Планфикс расположен на сервере в другой стране.
  4. В поле Поддомен ведите имя аккаунта в ПланФиксе. Например, если адрес аккаунта test.planfix.ru, введите test.
  5. В полях Логин для входа в PlanFix и Пароль введите логин и пароль, которые вы вводили при регистрации в ПланФикс.
  6. В поле Апи ключ введите аутентификационный ключ для доступа к API ПланФикс.  
  7. В поле Секретный ключ введите ключ подписи для доступа к API ПланФикс.

     Как получить аутентификационный ключ и ключ подписи для доступа к API ПланФикс
    1. В личном кабинете ПланФикс в правом верхнем углу окна вызовите контекстное меню Настройки и выберите Управление аккаунтом.

    2. Перейдите в раздел Доступ к API.

    3. В поле APIKey скопируйте аутентификационный ключ.

    4. В поле PrivateKey скопируйте ключ подписи.

  8. Введите идентификатор шаблона контакта.  

     Как получить идентификатор шаблона контакта
    1. В личном кабинете ПланФикс в панели навигации выберите Контакты.

    2. Перейдите в раздел Шаблоны.

    3. Напротив строки Шаблон контакта отображается нужный идентификатор:

  9. Введите идентификатор шаблона компании.  

     Как получить идентификатор шаблона компании
    1. В личном кабинете ПланФикс в панели навигации выберите Контакты.

    2. Перейдите в раздел Шаблоны.

    3. Напротив строки Шаблон компании отображается нужный идентификатор:

  10. Введите идентификатор шаблона задачи.

     Как получить идентификатор шаблона задачи
    1. В личном кабинете ПланФикс в панели навигации выберите Задачи.

    2. Перейдите в раздел Шаблоны задач.

    3. Напротив строки Стандарнтый шаблон отображается нужный идентификатор:

    (info) В Roistat загружаются все задачи, а не только те, которые удовлетворяют указанному шаблону. Шаблон задачи необходим для создания новых задач в проекте Roistat для последующей передачи в ПланФикс (см. Шаг 3).

  11. Нажмите Сохранить.
    Откроется раздел Распределение статусов, в котором загрузятся статусы задач из ПланФикс.
  12. Перетаскивая статусы задач, распределите их по группам. Подробнее читайте в статье Распределение статусов сделок.
  13. Нажмите Продолжить.
    Откроется раздел Расширенные настройки
  14. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.
  15. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей .
  16. Нажмите Сохранить.

Шаг 3. Настройте автоматическую отправку заявок в ПланФикс

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

(warning) Передача дополнительных полей в задачу Планфикс невозможна.

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

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

 

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

 

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

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

  1. В проекте Roistat откройте Каталог интеграций.
  2. В блоке Сейчас подключено на виджете настроенной интеграции с ПланФикс нажмите кнопку Настроить.
  3. В окне настройки интеграции пройдите по ссылке Список отправленных заявок.
  4. Проверьте статус отправки заявки: в поле Отправлен должен появиться статус отправки  , а в поле CRM – номер задачи в ПланФикс.
  • No labels