Интеграция лид-формы может продолжать выглядеть активной, хотя токен истек или права были отозваны. Реклама собирает обращения, но CRM их не получает, а проблема обнаруживается только после жалобы менеджера.

Сначала сравните число лидов в рекламном кабинете и CRM за одинаковый период. Затем проверьте последний успешный запрос, код ошибки API и владельца авторизации.

Что сделать в первую очередь

  • Зафиксируйте время последнего лида, попавшего в CRM.
  • Проверьте наличие новых заявок в кабинете и возможность их выгрузить.
  • Сохраните код ответа API и не публикуйте токен в журнале.
  • Предупредите менеджеров о временном ручном контроле заявок.

Почему возникает проблема

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

  • Истек короткоживущий токен или не сработало его обновление.
  • Сотрудник, выдавший доступ, потерял роль или удален из проекта.
  • Платформа изменила разрешения приложения или состав scopes.
  • Интеграция считает 401 обычной временной ошибкой и бесконечно повторяет запрос.

Пошаговая диагностика

  • Проверьте статус токена штатным debug endpoint платформы.
  • Сравните scopes с полями и формами, которые читает интеграция.
  • Посмотрите, регистрируются ли 401, 403 и ошибки обновления доступа.
  • Проверьте webhook-подписку и резервный периодический опрос.
  • Сопоставьте id лидов кабинета и CRM для поиска пропущенного диапазона.

Как исправить

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

  • Повторно авторизуйте интеграцию под служебным владельцем с минимальными правами.
  • Обновляйте токен до истечения и атомарно заменяйте сохраненное значение.
  • Останавливайте бесполезные retry при ошибке авторизации и создавайте критический алерт.
  • Дозагрузите пропущенные лиды по id с защитой от дублей.
  • Храните время последнего успешного получения отдельно для каждой формы.

Как проверить результат

  • Тестовый лид появляется в CRM и назначается ответственному.
  • Пропущенный диапазон дозагружен без повторных контактов.
  • Тест отзыва доступа вызывает алерт за заданное время.

Как не допустить повторения

  • Мониторьте возраст последнего лида и успешного API-запроса.
  • Назначьте владельца интеграции и календарь проверки доступов.
  • Добавьте ежедневную сверку количества лидов между системами.

Частые вопросы

Можно ли восстановить потерянные лиды?

Обычно да, если платформа хранит их и API позволяет выгрузку за прошедший период.

Почему обычный healthcheck не заметил проблему?

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

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

Если потерян большой период, сначала экспортируйте исходные id и создайте план дозагрузки. Это безопаснее массового повторного импорта по датам.

Итог

Интеграцию лид-форм нужно контролировать по факту поступления заявок, а не только по доступности сервера. Я могу восстановить доступ, вернуть пропущенные лиды и настроить раннее уведомление.