Перейти к содержанию

Интеграция Roistat с ПланФикс

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

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

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

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

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

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

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

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

  7. Нажмите Сохранить.

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

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

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

Как получить аутентификационный ключ и ключ подписи для доступа к API ПланФикс

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

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

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

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

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

Как получить идентификатор шаблона контакта

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

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

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

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

Как получить идентификатор шаблона компании

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

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

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

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

Как получить идентификатор шаблона задачи

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

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

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

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

  1. Нажмите Сохранить. Откроется раздел Распределение статусов, в котором загрузятся статусы задач из ПланФикс.

  2. Перетаскивая статусы задач, распределите их по группам. Подробнее читайте в статье Распределение статусов сделок.

  3. Нажмите Продолжить. Откроется раздел Расширенные настройки
  4. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.
  5. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей.
  6. Нажмите Сохранить.

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

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

Внимание!

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

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

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

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

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

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

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