Входящий Postback

Входящий Postback — это механизм приема входящих уведомлений от внешних систем. С его помощью PRMonline может принимать данные из сторонних сервисов, которые умеют отправлять webhook- или POST-запросы.

Важно: входящий Postback и API PRMonline — это разные способы интеграции.

• API используется для полноценного программного взаимодействия с PRMonline.

• Входящий Postback используется для приема входящих событий и данных от внешних систем по заранее настроенному URL.

Такой вариант интеграции подходит, если внешняя система умеет отправлять вебхуки или POST-запросы, а вам нужно передавать лиды, статусы, суммы сделок и другие данные в PRMonline.

Какие форматы запросов поддерживаются

Интеграция «Входящий Postback» поддерживает прием данных разными способами.

PRMonline умеет принимать параметры:

• из GET-запроса через query-параметры;

• из POST-запроса через query-параметры;

• из тела POST-запроса в формате JSON;

• из тела POST-запроса в формате form-data или x-www-form-urlencoded.

Важно: в одном запросе данные могут одновременно передаваться в query-параметрах и в теле запроса. Например, удобно статус передавать в query при указании целевого URL.

Как подключить

Чтобы подключить интеграцию «Входящий Postback», перейдите в кабинете администратора в раздел: Настройки → Интеграции

В блоке CRM найдите интеграцию «Входящий Postback» и нажмите «Подключить».

После этого откроется окно, в котором будут доступны:

• токен авторизации;

• URL для отправки входящих запросов.

Именно на этот URL внешняя система должна отправлять postback- или webhook-запросы.

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

В настройках необходимо указать, какие параметры входящего запроса соответствуют сущностям и полям PRMonline.

Например, внешний сервис может отправлять запрос в таком формате:

{
  "token": "jnb6c87gb8caugy793mp28",
  "reflinkid": "121135",
  "name": "Андрей Николаев",
  "phone": "+79108151506",
  "address": "Толбухина 9, пом. 13",
  "status": "NEW",
  "id": 3699157979,
  "sum": 900000
}

На первом шаге настройки нужно сопоставить параметры запроса с полями PRMonline.

Например:

• reflinkid — код реферальной ссылки;

• name — имя клиента;

• phone — телефон;

• address — адрес;

• status — статус лида;

• id — внешний идентификатор лида;

• sum — сумма сделки.

После заполнения настроек нажмите «Сохранить».

Маппинг статусов

На втором шаге настраивается соответствие статусов внешней системы и статусов PRMonline.

Значение целевого статуса должно быть передано в параметре status.

Если внешняя система использует собственные значения статусов, их нужно сопоставить со статусами PRMonline. Например:

• NEW → Новый

• IN_WORK → В работе

• SUCCESS → Сделка

• CANCELED → Отмена

После настройки маппинга нажмите «Сохранить».

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

Группировка лидов

На третьем шаге настраивается параметр группировки и поле, из которого будет передаваться сумма сделки.

Группировка используется для дедупликации лидов.

Например, если в качестве параметра группировки выбран id, то при повторной отправке запроса с тем же значением id новый лид создан не будет. Вместо этого PRMonline обновит уже существующий лид с таким же идентификатором.

Это удобно, если внешняя система отправляет несколько обновлений по одной и той же сделке или заявке.

Переопределение оффера

При необходимости можно включить переопределение оффера.

Эта настройка позволяет явно указать, какой оффер должен использоваться для расчета вознаграждения.

Для этого нужно выбрать параметр входящего запроса, в котором будет передаваться внешний идентификатор оффера.

Это полезно, если в зависимости от типа заказа, тарифа или продукта вознаграждение должно рассчитываться по разным правилам.

Подробнее об этом см. в разделе «Переопределение оффера».

Идентификатор и комментарий транзакции

Дополнительно можно настроить передачу:

• идентификатора транзакции;

• комментария транзакции.

Идентификатор транзакции должен быть уникальным. В качестве такого значения можно использовать, например:

• номер заказа;

• номер оплаты;

• идентификатор операции во внешней системе.

После завершения настройки нажмите «Завершить».

На основе переданных данных PRMonline создаст транзакцию, то есть начисление партнеру. В примере ниже был передан только идентификатор транзакции.

Как получить URL интеграции

Если вам нужно повторно посмотреть URL для отправки запросов, откройте:

Настройки → Интеграции → Входящий Postback → меню «•••» → Настроить

В открывшемся окне будет доступен URL со всеми ранее настроенными параметрами.

В открывшемся окне доступен URL со всеми параметрами, которые были настроены ранее.