Skip to main content
Проверяйте как первоначальный ответ API, так и последующие Webhook whatsapp.message.updated. Принятие запроса сервисом YCloud или Meta не подтверждает фактическую доставку. Приведенные ниже таблицы содержат задокументированные случаи ошибок. Они не представляют собой исчерпывающий список ошибок, которые могут возникать на стороне Meta. Актуальные сведения от провайдера доступны в справочнике по ошибкам Meta.

Сбой отправки сообщений со стороны YCloud

whatsappApiError в теле ответа

Вы можете получить тело ответа с ошибкой, содержащее поле error.whatsappApiError, при отправке сообщений WhatsApp через YCloud API, как правило, при использовании API прямой отправки сообщений WhatsApp (POST /v2/whatsapp/messages/sendDirectly). Вот пример ответа с ошибкой и HTTP-статусом 429, когда на один и тот же номер телефона отправляется слишком много сообщений:
В этом случае мы попытались отправить запрос к WhatsApp Business API и получили ответ с ошибкой. Поле error.whatsappApiError включено, чтобы помочь вам определить причину ошибки.

whatsappApiError в полезной нагрузке Webhook

Если вы используете API постановки сообщений WhatsApp в очередь (POST /v2/whatsapp/messages), вы никогда не получите ответ с ошибкой, содержащий error.whatsappApiError, поскольку мы отправляем ваши сообщения в WhatsApp Business API асинхронно. Вы можете получить эти данные, настроив Webhook для прослушивания событий whatsapp.message.updated. Вот пример полезной нагрузки Webhook:

коды ошибок, возвращаемые WhatsApp Business API

Поле whatsappApiError в точности соответствует ошибке WhatsApp Business Cloud API. Ниже перечислены некоторые возможные коды ошибок, которые могут возвращаться через YCloud API.

коды ошибок, возвращаемые YCloud API

Обратите внимание, что error.whatsappApiError не включается, если ошибки были обнаружены YCloud и запрос к WhatsApp Business API не выполнялся. Например, если вы укажете недействительный номер телефона, то получите следующий ответ с ошибкой:
Значение error.code представляет собой один из определяемых сервером YCloud кодов ошибок. Ниже приведены некоторые возможные коды ошибок, возвращаемые YCloud API:

Коды ошибок YCloud, передаваемые через Webhook

Если вы используете эндпоинт постановки сообщения WhatsApp в очередь (POST /v2/whatsapp/messages), доставка может завершиться ошибкой YCloud. То есть whatsappMessage.errorCode в теле Webhook также может передавать один из кодов ошибок YCloud, например BALANCE_INSUFFICIENT. Вот некоторые возможные ошибки:

Сбой отправки сообщений со стороны Meta

Не все коды ошибок, перечисленные на странице WhatsApp Business Cloud API Error, возвращаются через YCloud API. Даже если сообщение успешно передано в WhatsApp Business API, его отправка все равно может завершиться ошибкой. Meta уведомляет YCloud об этих ошибках через Webhook. Вам следует настроить Webhook для прослушивания событий whatsapp.message.updated, чтобы получать эти уведомления от YCloud. Ниже приведен пример полезной нагрузки Webhook для сообщений, которые были отправлены, но в итоге завершились ошибкой:
whatsappMessage.errorCode передает код ошибки WhatsApp Business API.

Коды ошибок Meta, передаваемые через Webhook

Ниже перечислены некоторые возможные коды ошибок, передаваемые через Webhook YCloud и полученные от Webhook Meta: