whatsapp.message.updated. Ошибка при отправке сообщения может произойти, когда YCloud проверяет ваш запрос, когда отправляет сообщение в WhatsApp или уже после того, как WhatsApp принял сообщение к доставке. Используйте возвращенный код и сведения об ошибке, чтобы определить причину перед повторной попыткой.
Где найти код ошибки
Эндпоинт с очередью возвращает ответ до того, как сообщение отправляется в WhatsApp, поэтому его первоначальный ответ не может сообщить о последующей ошибке отправки. Синхронный эндпоинт сообщает результат отправки, но сбой с сообщением всё равно может произойти позже. Принятый запрос не подтверждает доставку; отслеживайте вебхуки для обоих эндпоинтов.
Чтение кода и сведений об ошибке
Разделяйте ошибку запроса YCloud и вышестоящую ошибку WhatsApp. Например, синхронный ответ может содержатьerror.code: "TOO_MANY_REQUESTS" и error.whatsappApiError.code: "131056". Первое описывает ответ API; второе указывает на ограничение частоты сообщений между отправителем и получателем.
В вебхуке о сбое доставки сообщения поле whatsappMessage.errorCode может содержать как код YCloud, такой как BALANCE_INSUFFICIENT, так и код WhatsApp, например 131048. Сохраняйте его как строку.
Если поле whatsappApiError доступно, проверьте его поля code и error_data для определения конкретной причины. Для ошибок API сообщений поле error_data может содержать свойство details; для ошибок API шаблонов оно может быть строкой. Сопоставляйте коды, а не заголовки ошибок или текст сообщений, так как они могут меняться.
Приведенные ниже числовые коды относятся к вышестоящим ошибкам WhatsApp. Информацию о кодах YCloud, таких как UNAUTHORIZED, PARAM_INVALID или BALANCE_INSUFFICIENT, см. в разделе Обработка ошибок.
Сведения об эндпоинтах отправки см. в разделе Отправка сообщения WhatsApp, а информацию о получении обновлений статуса сообщений — в разделе Настройка вебхуков.
Лимиты на отправку и ограничения по качеству
Информацию об ограничениях качества и лимитах на уровне получателей см. в разделе Контроль качества и доставки.
Ошибки получателя и доставки
Ошибки шаблонов и сообщений Flow
Перед повторной попыткой проверьте точное название шаблона, язык, статус и определения компонентов в YCloud.
См. Управление шаблонами WhatsApp и Управление WhatsApp Flows.
Параметры сообщений и медиафайлы
См. Отправка сообщения WhatsApp и Загрузка медиафайлов WhatsApp.
Аккаунт, номер телефона и биллинг
Ошибки маркетинговых сообщений
Эти ошибки могут возникать, когда YCloud отправляет сообщение через Meta Marketing Messages API. Используйте возвращенные подробности, чтобы различить проблемы с шаблонами, синхронизацией и маршрутизацией.
Для этого маршрута
100 может означать, что сообщение должно быть шаблонным, а 131009 может указывать на недопустимые параметры или незавершенную синхронизацию шаблона. Используйте возвращенные подробности, чтобы определить точную причину. В случае незавершенной синхронизации подождите 10 минут перед повторной попыткой.
Временные ошибки сервиса
Повторные попытки и эскалация
- Перед повторной попыткой исправьте некорректные параметры, статус шаблона, ограничения аккаунта и проблемы с медиафайлами.
- Учитывайте отказы получателей от рассылок и блокировки. Не повторяйте попытки отправки при таких сбоях автоматически.
- Для временных сбоев используйте экспоненциальную задержку, джиттер и ограничение максимального количества попыток. Соблюдайте период ожидания, указанный выше или в ответе.
- Перед повторной отправкой после таймаута или неоднозначного ответа сверьте статус сообщения во избежание дублирования. Поле
externalIdслужит для корреляции; не предполагайте, что оно обеспечивает дедупликацию отправок.
requestId YCloud, id сообщения, а также wamid или fbtrace_id (при наличии). Удалите API-ключи и ненужные персональные данные.