Получение новых задач из ПланФикса Отправка лида в Traffic Light

Интеграция

Получение новых задач из ПланФикса → Отправка лида в Traffic Light

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

  1. Настройка приёма новых задач из ПланФикса: выбор подключения, копирование URL и POST из автоматического сценария в момент создания задачи.
  2. Настройка отправки лида в Traffic Light: ключ API, ID оффера, телефон, IP-адрес и дополнительные поля заявки из данных сценария.

Отдельные инструкции: источник «Получение новых задач из ПланФикса» · действие «Отправка лида в Traffic Light»

Не хотите настраивать сами? Сделаем бесплатно

Напишите, какие сервисы нужно связать. Специалист настроит интеграцию, проверит, что данные доходят, и оставит вам готовый процесс.

Получить бесплатную настройку Или следуйте инструкции ниже

Создание подключений

Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.

Подключение ПланФикса

Создание подключения

  1. В меню откройте «Подключения» и нажмите «+».
  2. Выберите «ПланФикс» и нажмите «Выбрать».
  3. В поле «Название» укажите, как подключение будет видно в сценариях.
  4. В поле «Портал» выберите «planfix.ru» или «planfix.com».
  5. Нажмите «Подключить».
  6. На странице ПланФикса выберите аккаунт и разрешите доступ.

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

integrations: В левом меню откройте «Обработки» и нажмите «+»

Источник «ПланФикс: Новая задача»

Новые задачи из ПланФикса начнут поступать после выбора подключения и сохранения источника. Скопируйте URL и отправьте на него POST из автоматического сценария в момент создания задачи.

Выбор типа источника

  1. В списке типов источника выберите «ПланФикс: Новая задача» и нажмите «Выбрать».

Подключение

  1. В поле «Подключение» выберите аккаунт ПланФикса.
  2. Нажмите «Сохранить».

URL приёма

  1. Откройте вкладку «Источник данных» и скопируйте «URL».

Сценарий в ПланФиксе

  1. В ПланФиксе откройте «Управление аккаунтом» → «Автоматические сценарии».
  2. Создайте сценарий для задач с событием создания задачи.
  3. Добавьте действие «Отправить HTTP-запрос»: метод POST, адрес - скопированный «URL».
  4. В тело запроса передайте поля задачи JSON-объектом или параметрами формы.

Принимаются такие поля:

  • id - номер задачи
  • name - название
  • description - описание
  • priority - приоритет
  • status_id - ID статуса
  • status_name - статус
  • process_id - ID процесса
  • project_id - ID проекта
  • assigner_id - ID постановщика
  • counterparty_id - ID контрагента
  • assignees - исполнители через запятую
  • start - начало
  • end - срок

Подойдёт и JSON задачи ПланФикса: вложенные status, project, assigner, counterparty и assignees разбираются в эти поля.

Пример тела:

{"id":"123","name":"Заявка с сайта","description":"Нужен звонок"}

Как устроены исходящие запросы: HTTP-запросы в ПланФиксе.

Действие «Отправка лида в Traffic Light»

Отправляйте заявки в CPA-сеть Traffic Light (cpa.tl) прямо из сценария. Укажите ключ API и ID оффера, подставьте телефон, IP и остальные поля лида - после выполнения действия получите код лида и данные о выплате.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

Отправка лида в Traffic Light

Обязательные поля

  1. В поле «Ключ доступа к API» вставьте ключ из профиля кабинета Traffic Light.
    Отправка лида в Traffic Light: В поле «Ключ доступа к API» вставьте ключ из профиля кабинета Traffic Light
  2. В поле «ID оффера» укажите идентификатор оффера в Traffic Light.
    Отправка лида в Traffic Light: В поле «ID оффера» укажите идентификатор оффера в Traffic Light
  3. В поле «Телефон покупателя» укажите телефон или подставьте переменную из источника. Формат номера может быть любым.
  4. В поле «IP-адрес» укажите IP лида. Если IP получить нельзя (лид-формы Facebook, TikTok и т.п.), укажите 0.0.0.0

Рекомендуемые поля

  1. В «ФИО покупателя» укажите имя или ФИО клиента.
  2. В «ID потока» вставьте ID потока со страницы потоков.
  3. В «Строка User-Agent» при возможности передайте User-Agent клиента - это помогает контролировать трафик.
  4. В «ID лида» можно передать ID заявки из вашего источника (Facebook, TikTok, CRM).
  5. В «ID вебмастера» укажите свой идентификатор в вашей системе или 0.

Дополнительные поля

  1. При необходимости заполните «Комментарии к заказу», «Код страны покупателя», «Адрес покупателя», «Временная зона» и «Email покупателя».
  2. В «Код страны покупателя» укажите код Alpha-2, например RU или KZ. Список кодов есть в ISO 3166-1.
  3. В «Временная зона» укажите число смещения, например 3 для Europe/Moscow.
  4. При необходимости заполните UTM-метки: «UTM Source», «UTM Medium», «UTM Campaign», «UTM Content», «UTM Term».
  5. При необходимости заполните «Доп. инфо 1» … «Доп. инфо 5» и «Доп. инфо 1024».
  6. Нажмите «Сохранить».

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»

Застряли на подключении или полях?

Соберём обработку «Получение новых задач из ПланФикса → Отправка лида в Traffic Light», проверим тест и запустим.