Erros

O Fiwano informa um problema de uma de duas formas:

• A requisição é recusada com um status HTTP 4xx/5xx — veja Erros HTTP. Um 4xx de um endpoint de envio significa que nenhuma mensagem foi enviada.
• A mensagem falha. Os endpoints de envio respondem 200 com success: false e status: "failed", ou um envio que respondeu queued termina depois em um webhook message.failed. Quando a causa é da Meta, o motivo está no código de erro de envio.

Erros HTTP

O corpo tem um campo detail, normalmente uma descrição legível:

{ "detail": "Channel is inactive" }

Um erro de validação (422) lista os campos com problema em detail. As rejeições que você pode querer tratar no código trazem um detail estruturado com um code estável, uma message e normalmente um hint:

Não dependa do corpo de um 5xx; use o status e Retry-After. Os códigos por endpoint estão na Referência da API.

Códigos de erro de envio

Quando a Meta rejeita uma mensagem, o código de erro dela chega a você sem alteração:

• na resposta do envio, como error_code junto de status: "failed";
• em um webhook message.failed, como errors[].code, com error_subcode e error_data.details quando a Meta os informou.

error traz o motivo legível: o texto da própria Meta, mais uma dica do Fiwano quando o texto da Meta não explica o problema.

A coluna Repetido vale para envios de texto e mídia: esse envio responde queued e o Fiwano tenta de novo — veja Entrega e novas tentativas. send-template nunca repete: ali todo erro retorna failed, com o código da Meta em error_code.

Outros códigos chegam como a Meta os retorna, e o Fiwano repete qualquer código que não saiba ser permanente. Listas completas da Meta: WhatsApp, Messenger e Instagram.

Erro 10

A Meta retorna 10 para causas sem relação entre si. O texto em error as diferencia: