Не считайте уведомление гарантией доставки
Webhook сообщает другой системе о событии через HTTP-запрос. Получатель может быть недоступен, ответ потеряется, а отправитель повторит доставку или больше не попытается — это зависит от конкретного сервиса. До разработки прочитайте правила поставщика: таймаут, повторные попытки, срок хранения и возможность ручного восстановления. Нельзя переносить поведение одной платформы на все интеграции. Запишите, откуда можно получить список исходных изменений для сверки. Если единственным доказательством события остаётся одна незафиксированная попытка доставки, восстановить полноту после длительного сбоя будет трудно.
Разделите приём и бизнес-результат
Быстрый ответ отправителю полезен, но его нужно связать с фактически принятым состоянием. После необходимых проверок сохраните событие надёжным способом и определите, что означает успешный ответ: принято в обработку или уже выполнено. Если вы подтвердили доставку до сохранения и процесс остановился, отправитель может не повторить запрос. Дальнейшая обработка получает отдельный статус, попытки и причину ошибки. Не показывайте менеджеру «готово», когда сообщение только поставлено в очередь. Интерфейс и журнал должны различать полученное событие, начатую операцию и подтверждённое изменение в целевой системе.
| Состояние | Подтверждение |
|---|---|
| Принято | Событие сохранено с идентификатором |
| Выполняется | Есть конкретная попытка обработки |
| Результат неизвестен | Нужна сверка после сбоя ответа |
| Завершено | Проверена запись в целевой системе |
Учитывайте повтор и порядок событий
Устойчивый идентификатор события помогает распознать повтор доставки, но обновления одного объекта остаются самостоятельными событиями. Сохраните связь с версией объекта и правила обработки устаревших изменений. Не полагайтесь на порядок прихода, если поставщик его не гарантирует. Повторное событие должно возвращать известный результат или безопасно продолжать незавершённую операцию. В некоторых случаях удобнее прочитать текущее состояние объекта в источнике, но это не подходит для всех видов действий. Правило нужно выбирать по смыслу процесса, особенно для отмен, удаления и операций с необратимыми последствиями.
Учебная ситуация: сначала пришло изменение статуса на «отменён», затем задержавшееся сообщение «создан». Если обработчик просто применит последнее полученное значение, он восстановит отменённую заявку. Версия объекта или проверка актуального состояния помогают выявить такой порядок до записи.
После таймаута установите фактический результат
CRM могла создать карточку, хотя интеграция не получила ответ. Слепой повтор создаст дубль, а безусловный отказ оставит исход неизвестным. Предусмотрите поиск по внешнему ключу, проверку состояния операции или ручную сверку, если API не даёт надёжного механизма. Ограничьте число повторов и различайте временный сбой, неверные данные и отсутствие прав. Отложенные повторные попытки не должны бесконечно занимать очередь. Случай, который нельзя разрешить автоматически, передайте оператору с исходным событием, историей попыток и доступным безопасным действием. Сопоставление внешних ключей также важно при синхронизации CRM и учётной системы.
Сверяйте полноту независимо от доставки
Периодическая сверка источника и назначения помогает найти события, которые не дошли вообще. Определите контрольный период, доступные идентификаторы и допустимую задержку. Сравнение только общего количества недостаточно: одна пропущенная и одна лишняя запись могут дать одинаковый итог. Для восстановления сначала подготовьте список расхождений и пробный прогон, затем повторите только нужные операции. Учтите, что исходные данные могли измениться после события. Оператор должен понимать, восстанавливает ли он историческое действие или синхронизирует текущее состояние. Эти варианты требуют разных проверок и не должны смешиваться незаметно.
Проведите учение по восстановлению
На тестовом контуре пройдите недоступность получателя, потерю ответа, повтор, нарушение порядка и неверные права. Отдельно проверьте подлинность входных запросов средствами выбранного поставщика, защиту секретов и ограничения объёма. Зафиксируйте остановку, повторную сверку и критерий завершения восстановления. Сроки обнаружения и доступность истории должны соответствовать цене ошибки процесса. Документация с проверенным маршрутом восстановления полезнее обещания «интеграция сама всё повторит», которое не учитывает реальные возможности источника и CRM. Такой маршрут входит в проектирование CRM-интеграций с журналом обмена.
Примените к своей задаче
Опишите один канал обращений и используемую CRM. Обсудим поля, ответственных, повторы и первый маршрут для проверки.
Разобрать маршрут заявок →