Skip to main content
Verifique tanto a resposta inicial da API quanto os webhooks whatsapp.message.updated posteriores. A aceitação pela YCloud ou pela Meta não confirma a entrega. As tabelas abaixo restabelecem os casos de erro documentados. Elas não são uma lista exaustiva de erros que a Meta pode introduzir. Para detalhes atualizados do provedor, use a referência de erros da Meta.

A YCloud não conseguiu enviar mensagens

whatsappApiError no corpo da resposta

Você pode receber um corpo de resposta de erro incluindo o campo error.whatsappApiError ao enviar mensagens do WhatsApp pela API da YCloud, normalmente a API Enviar uma mensagem do WhatsApp diretamente (POST /v2/whatsapp/messages/sendDirectly). Aqui está um exemplo de resposta de erro com status HTTP 429 quando você envia mensagens em excesso para o mesmo número de telefone:
Nesse caso, tentamos fazer a solicitação à WhatsApp Business API e recebemos uma resposta de erro. O error.whatsappApiError é incluído para ajudar você a identificar o motivo do erro.

whatsappApiError no payload do webhook

Se você estiver usando a API Enfileirar uma mensagem do WhatsApp (POST /v2/whatsapp/messages), nunca receberá uma resposta de erro contendo error.whatsappApiError, pois enviamos suas mensagens para a WhatsApp Business API de forma assíncrona. Você pode obtê-la configurando um webhook para escutar eventos whatsapp.message.updated. Aqui está um exemplo do payload do webhook:

códigos de erro retornados pela WhatsApp Business API

O whatsappApiError é exatamente o WhatsApp Business Cloud API Error. Listados abaixo estão alguns códigos de erro possíveis que podem ser retornados por meio da API da YCloud.

códigos de erro retornados pela API da YCloud

Esteja ciente de que error.whatsappApiError não é incluído quando os erros são detectados pela YCloud e não chegamos a chamar a WhatsApp Business API. Por exemplo, quando você fornece um número de telefone inválido e recebe a seguinte resposta de erro:
O error.code é um dos códigos de erro definidos pelo servidor da YCloud. Abaixo estão listados alguns possíveis códigos de erro retornados pela API da YCloud:

Códigos de erro da YCloud transmitidos por webhooks

Se você estiver usando o endpoint Enqueue a WhatsApp message (POST /v2/whatsapp/messages), a mensagem pode falhar devido a um erro da YCloud. Ou seja, o whatsappMessage.errorCode no payload do webhook também pode transmitir um dos Códigos de Erro da YCloud, como BALANCE_INSUFFICIENT. Aqui estão alguns erros possíveis:

A Meta falhou ao enviar mensagens

Nem todos os códigos de erro listados na página de Erros da WhatsApp Business Cloud API são retornados por meio da API da YCloud. Mesmo que uma mensagem seja enviada com sucesso para a WhatsApp Business API, o envio ainda pode falhar. A Meta notifica a YCloud sobre esses erros via webhooks. Você deve Configurar Webhooks escutando eventos de whatsapp.message.updated para receber essas notificações da YCloud. Aqui está um exemplo do payload do webhook para mensagens enviadas, mas que falharam no final:
O whatsappMessage.errorCode transmite o código de Erro da WhatsApp Business API.

Códigos de erro da Meta transmitidos por webhooks

Listados abaixo estão alguns códigos de erro possíveis transmitidos pelos webhooks da YCloud, originados dos webhooks da Meta: