Лидпульт

Почему лид отклонён: коды API и подстатусы клиники

Заявка может не пройти приём на входе (ответ API с кодом) или быть отклонённой клиникой после обзвона (подстатус). Это две разные ситуации с разными способами исправления. Разберём обе.

· 6 мин чтения

Два уровня отказа

Первый уровень — приём заявки. Система проверяет ключ, статус аккаунта, оффер, гео, телефон, лимит и дубль. Если проверка не пройдена, заявка вообще не создаётся, а в ответе вы получаете код причины. Этот уровень вы видите сразу, в момент отправки.

Второй уровень — работа клиники. Заявка принята, передана клинике, и после обзвона клиника проставляет подстатус. Подстатус определяет итог: принят, холд или отменён. Этот уровень проявляется с задержкой и виден в статусе лида и в постбэке.

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

Коды отказа при приёме (API)

КодHTTPЧто значит и что делать
bad_request400Не хватает обязательных полей. Проверьте wmkey, apikey, offer_id, city, phone.
bad_key401Неверная пара ключей. Проверьте значения или перевыпустите ключ.
blocked403Аккаунт заблокирован. Напишите менеджеру.
geo_closed403Город по офферу вам не открыт. Выберите другой город или запросите открытие.
offer_not_found404Такого оффера нет. Проверьте offer_id.
offer_not_live409Оффер на паузе или остановлен. Не лейте трафик.
duplicate409Этот телефон уже приходил по офферу за 30 дней. Повторять не нужно.
city_not_found422Город не распознан. Передайте название из списка или номер города.
bad_phone422Телефон некорректен. Проверьте форму и валидацию номера.
limit_reached429Дневной лимит по офферу и городу исчерпан. Сутки считаются по Москве.

Кроме этих кодов, заявка не принимается, когда у клиники не хватает свободных денег: приём останавливается с причиной client_no_funds, а оффер в кабинете показан как приостановленный. Повторять запросы имеет смысл только при сетевой ошибке и ответах 5xx. Подробнее — в инструкции по отправке лида и в документации API.

Шаги: разбор отказа на входе

  1. Посмотрите HTTP-статус и поле code в ответе.
  2. Сопоставьте код с таблицей выше.
  3. Если код связан с вашими настройками (bad_key, bad_request, city_not_found, bad_phone), исправьте запрос и проверьте на тестовой заявке.
  4. Если код связан с состоянием оффера (offer_not_live, limit_reached, client_no_funds), остановите или перераспределите трафик и вернитесь к вопросу позже.
  5. Если код blocked или geo_closed, напишите менеджеру с описанием ситуации.
  6. Если коды duplicate появляются часто, проверьте источник: возможно, форма отправляет один номер несколько раз или трафик повторный.
Долю ответов duplicate, bad_phone и limit_reached полезно отслеживать отдельно: это самые частые сигналы проблем с качеством трафика и планированием объёма.

Подстатусы клиники: когда заявка отклоняется после приёма

Клиника после звонка проставляет подстатус. В числе подстатусов:

  • пришла на приём; купила услугу; записана; отложила запись;
  • не отвечает; просила перезвонить;
  • дубль; неверный номер; другой город; не подходит по возрасту; не оставляла заявку; противопоказания; уже клиент клиники.

Подстатус определяет итог: принят и оплачивается, холд и остаётся в работе, либо отменён. Подстатусы вроде «не отвечает» или «просила перезвонить» обычно означают незавершённую работу с заявкой, а «неверный номер», «не оставляла заявку» или «дубль» говорят о проблеме качества источника. В вашем кабинете виден итоговый статус и, по возможности, причина.

Что исправлять, если отказов много

  • «Не оставляла заявку». Проверьте источник трафика: заявка могла быть создана без осознанного действия человека или за вознаграждение. Это серьёзное нарушение.
  • «Неверный номер». Добавьте проверку телефона на форме и не принимайте заявки с заведомо ложными номерами.
  • «Другой город». Уточните таргетинг по гео и форму выбора города.
  • «Не подходит по возрасту» и «противопоказания». Прочитайте условия оффера и сузьте аудиторию. Реклама медицинских услуг должна содержать предупреждение о противопоказаниях.
  • «Дубль» и «уже клиент клиники». Исключите из аудитории существующих клиентов, если такая возможность есть.
  • Много «не отвечает». Если это системно по одному источнику, проверьте качество и время подачи заявок.

Типичные ошибки

  • Повторять запрос при ответе 4xx: результат не изменится.
  • Считать отклонённой заявку в холде: итог ещё не определён.
  • Объяснять все отказы «плохой клиникой», не проверив собственные источники.
  • Не читать заметку к офферу: ограничения клиники указаны там.
  • Продолжать лить на оффер, ответивший кодом offer_not_live.

Если вы не согласны с итогом по конкретной заявке, соберите её номер, метки и подстатус и напишите менеджеру. Решение по спорным ситуациям принимает администратор сети.

Как вести журнал причин отказов

Единичные отказы — часть работы. Системные — повод менять связку. Чтобы отличать одно от другого, заведите простую таблицу причин отказа по источникам. Раз в неделю заносите туда число заявок с кодами duplicate, bad_phone, limit_reached, а также число заявок, отклонённых клиникой, с разбивкой по подстатусам. Через месяц вы увидите закономерности: например, что определённая кампания в разы чаще даёт неверные номера.

Особое внимание уделяйте подстатусу «не оставляла заявку». Он означает, что человек не помнит или отрицает, что оставлял заявку. Это один из главных признаков некачественного или мотивированного трафика, и клиника, и сеть реагируют на него строго.

  • Если доля такой причины растёт, остановите кампанию и проверьте механику привлечения.
  • Сопоставьте метки отклонённых заявок: проблема обычно в одном креативе или площадке.
  • Не пытайтесь «перекрыть» плохие заявки хорошими: клиника тоже видит качество.

Куда обращаться за помощью

Если причину отказа не удаётся определить, напишите менеджеру сети через раздел контактов или в рабочем канале связи. Приложите: номер лида или apiid, время запроса, ответ API целиком, метки и описание ожидаемого поведения. Чем точнее данные, тем быстрее найдётся причина. Не присылайте секретный ключ API: для диагностики он не нужен.

Памятка вебмастера на каждый день

  1. Утром проверяйте статус офферов и остаток лимитов.
  2. Раз в несколько часов смотрите долю ответов с кодами 4xx в своём трекере.
  3. Вечером проверяйте журнал постбэка и подстатусы свежих заявок.
  4. При росте доли отказов останавливайте проблемный источник и разбирайтесь, прежде чем продолжать.

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

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

Почему ответ duplicate, хотя я не отправлял этот номер?

Возможно, номер уже приходил по этому офферу за последние 30 дней — от вас или другого источника. Проверьте историю лидов.

Чем отличается отклонённый лид от лида в холде?

Отклонённый получил итог «отменён», а лид в холде ещё в работе: итог пока не определён.

Можно ли оспорить подстатус?

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

Что значит client_no_funds?

У клиники закончились свободные деньги, и приём заявок остановлен. Оффер в кабинете показан как приостановленный.

Повторять ли запрос при limit_reached?

Нет, до новых суток по Москве ответ не изменится. Перераспределите трафик на другие города или офферы.