Постбэки: настройка и частые вопросы
Постбэк возвращает статусы заявок в ваш трекер. Разбираем адрес, макросы, повторы и типичные причины, по которым статусы не доходят.
Что делает постбэк
Постбэк — это запрос Лидпульта на адрес, который вы задали в кабинете. Он уходит при приёме заявки и при каждой смене её статуса. Благодаря этому трекер знает, какие связки приводят принятые заявки, и вы считаете окупаемость по фактическим результатам.
Как подготовить адрес
Адрес задаётся в разделе интеграции. Используйте макросы, которые сеть подставит в момент отправки, например %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 и разбирайте их на стороне трекера. Так одним адресом можно обслуживать несколько потоков.
Менялся ли статус задним числом у выплаченной заявки?
Нет. Выплаченный лид не меняет статус задним числом. Если требуется корректировка, её делает администратор сети отдельной ручной операцией. Подробнее — на странице про споры по статусам.