Códigos de Erro do Log

Em Logs (/logs), o Código de erro exibido nos detalhes de um envio com falha é sempre um dos valores abaixo. A API do painel expõe o mesmo valor como errorCode em GET /api/logs (derivado no servidor a partir de campos armazenados; não é o mesmo que errorMessage).

Códigos (conjunto fechado)

Code	Significado
`DELIVERED_NOT_CONFIRMED`	A mensagem foi enviada com sucesso, mas a confirmação de entrega não chegou antes do prazo (deliverUntil); marcada como FAILED após o prazo.
`TEMPLATE_VERSION_NOT_FOUND`	Template ou versão do template não encontrado para a mensagem.
`INVALID_DESTINATION`	Destino inválido ou falha na normalização E.164.
`PILOT_SELF_NUMBER`	Envio bloqueado para o próprio número da Pilot Status na instância da Pilot Status.
`NEVER_ATTEMPTED_MAX_AGE_EXCEEDED`	A mensagem permaneceu QUEUED por 7 dias com zero tentativas de envio (a instância ficou offline o tempo todo); expirou após as verificações automáticas de prazo.
`EXPIRED_AFTER_ATTEMPTS`	deliverUntil expirou após pelo menos uma tentativa real de envio. A janela de entrega expirou enquanto o destino estava inacessível.
`MESSAGE_EXPIRED`	Legado: expiração de deliverUntil ou comportamento de expiração antigo não coberto pelos códigos acima.
`DELIVERY_TIMEOUT`	Timeout de entrega, instância desconectada/fechada, instância não encontrada no provedor, ou outras falhas de entrega sem um código mais específico acima.
`NUMBER_NOT_FOUND_REMOVED`	A instância/número conectado foi removido no provedor.
`LINKED_WHATSAPP_INSTANCE_NOT_FOUND`	A chave de API estava vinculada a uma instância do WhatsApp que não existe mais (registro removido ou id inválido).
`WHATSAPP_NOT_EXIST`	O número de destino não está registrado no WhatsApp (resposta do provedor indicando número não registrado).
`META_TEMPLATE_NOT_APPROVED`	Template não aprovado para a Meta Cloud API. O template deve ser enviado e aprovado pela Meta antes de enviar mensagens por um número Meta.
`META_OUTSIDE_24H_WINDOW`	Janela de conversa de 24h fechada. Use um template aprovado para enviar mensagem a este número.
`META_NO_CONVERSATION`	Não existe conversa com este número. Inicie com um template aprovado.
`META_RATE_LIMITED`	Limite de envio da Meta atingido. Aguarde alguns minutos e tente novamente.
`META_TOKEN_INVALID`	O token da Meta é inválido ou expirou. Atualize o System Token nas configurações do número.
`META_SEND_FAILED`	Falha genérica de envio da Meta Cloud API.
`FREE_FORM_NOT_SUPPORTED`	Mensagens de formato livre não são suportadas para este provedor de WhatsApp.
`NUMBER_CONNECTION_LIMIT_REACHED`	Um único número de WhatsApp atingiu seu limite de 4 conexões. Remova uma conexão existente antes de adicionar uma nova. HTTP 409.
`META_WABA_NOT_ACCESSIBLE`	O ID da WABA (WhatsApp Business Account) associado a este número não existe ou o system token não tem permissão para acessá-lo. Retornado quando “Sincronizar com a Meta” falha com o código de erro 100 / subcódigo 33 da Meta.
`SEND_FAILED`	Todas as outras falhas (incluindo erros de envio HTTP ou do provedor, mensagens de diagnóstico genéricas e qualquer caso sem um código mais específico acima).

Uma mensagem CANCELED (cancelada via DELETE /v1/messages/cancel) não é um erro de entrega e não carrega um desses códigos.