Лидпульт

Постбэки: настройка и частые вопросы

Постбэк возвращает статусы заявок в ваш трекер. Разбираем адрес, макросы, повторы и типичные причины, по которым статусы не доходят.

Что делает постбэк

Постбэк — это запрос Лидпульта на адрес, который вы задали в кабинете. Он уходит при приёме заявки и при каждой смене её статуса. Благодаря этому трекер знает, какие связки приводят принятые заявки, и вы считаете окупаемость по фактическим результатам.

Как подготовить адрес

Адрес задаётся в разделе интеграции. Используйте макросы, которые сеть подставит в момент отправки, например %lead_id%, %status%, %payout%, %sub1%. Адрес должен быть публичным: http или https, порты 80 или 443. Подробности — в документации API.

Вопросы и ответы

Когда уходит постбэк?

При приёме заявки и при каждой смене статуса. Если заявка прошла путь от приёма к клинике, затем в холд и далее в принятые, вы получите отдельные вызовы на каждом шаге. Значения статуса передаются макросом %status%.

Какие значения принимает %status%?

new — принят системой, sent — передан клинике, hold — в работе, accepted — принят и выплата начислена, canceled — отклонён, paid — выплачен. Для трекера обычно достаточно сопоставить accepted с целевым событием, а canceled — с отказом.

Какие макросы доступны?

%lead_id%, %status%, %payout%, %offer%, %offers_id%, %cities_id%, %landings_id%, %createtime%, %sub1%…%sub5%, %apiid%, %estimation% и %estimationflag%. Не обязательно использовать все: выберите те, что нужны трекеру для сопоставления с кликом.

Как связать постбэк с кликом в трекере?

Передавайте в заявке идентификатор клика в метке sub или в apiid, а в адресе постбэка подставляйте обратно %sub1% или %apiid%. Так трекер найдёт исходный клик и запишет результат. Выбор поля зависит от логики вашего трекера.

Как проверить постбэк?

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

Что будет, если трекер не ответил?

Если трекер не ответил или вернул ответ 5xx, сеть повторяет отправку: через 30 секунд, затем через 1, 2, 4 и далее минут, до 8 попыток. Журнал отправок показывает каждую попытку, поэтому вы видите, на каком этапе возникла проблема.

Почему адрес постбэка не принимается?

Адрес должен быть публичным, с протоколом http или https и портом 80 или 443. Адреса внутренних сетей и localhost не принимаются. Кроме того, внешние запросы идут без редиректов и с таймаутом, поэтому адрес с цепочкой перенаправлений может не сработать.

Почему постбэк не доходит до трекера?

Типичные причины: ошибка в адресе, закрытый доступ к серверу трекера из внешней сети, неверный порт, редирект на другой адрес, долгий ответ (таймаут). Проверьте журнал отправок: в нём виден результат запроса и можно понять, на какой стороне сбой.

Приходит ли постбэк на отклонённую заявку?

Если заявка уже принята системой и затем клиника отменила её, придёт вызов со статусом canceled. Заявки, не прошедшие проверки при приёме, лидом не становятся, поэтому для них постбэк не отправляется: ответ вы получаете сразу в самом API.

Можно ли получать постбэки по каждому потоку отдельно?

Адрес постбэка задаётся в кабинете, а различать потоки удобно через метки: передавайте в заявке нужные значения в sub1…sub5 и разбирайте их на стороне трекера. Так одним адресом можно обслуживать несколько потоков.

Менялся ли статус задним числом у выплаченной заявки?

Нет. Выплаченный лид не меняет статус задним числом. Если требуется корректировка, её делает администратор сети отдельной ручной операцией. Подробнее — на странице про споры по статусам.