Códigos de Erro e Status

Esta referência consolida os códigos e status documentados nas páginas de produto e integração. Itens marcados como “não documentado” precisam ser confirmados com engenharia antes de serem tratados como garantidos.

Status de mensagem (Webhook)

Enviado no evento message_status do Webhook de Eventos, em details.status.id:

ID	Status
1	Queued
2	Sent
3	Delivered
4	Failed
5	Read

Canal da mensagem, em details.channel.id:

ID	Canal
1	Email
2	SMS
3	Whatsapp

O canal RCS não aparece na referência de details.channel.id documentada para o Webhook de Eventos — a confirmar com engenharia antes de assumir um valor.

details.provider.details.status / statusDescription trazem o status bruto retornado pelo broker (específico de cada provedor) — não confundir com details.status.id, que é o status normalizado do Maestro.

Status de template

Veja a lista completa e o ciclo de vida em Templates:

Status	Canais	Significado
Em criação	E-mail	Template em desenvolvimento, ainda não submetido para revisão.
Em revisão	Todos	Submetido para revisão, aguardando análise.
Aprovado	Todos	Aprovado pelo revisor, ainda não publicado no broker.
Publicado	Todos	Aprovado e disponível para uso no broker.
Rejeitado	Todos	Reprovado pelo revisor (motivo disponível para consulta).
Expirado	Todos	Expirou pela configuração de expiração de templates.
Rejeitado por Meta	WhatsApp	Aprovado internamente, mas rejeitado pela Meta.

Direct Message API — códigos HTTP

Veja o detalhamento e exemplos de corpo de resposta em Direct Message API.

Código	Significado
`200 - OK`	Mensagem validada, mas não enviada — canal sem broker configurado.
`202 - Accepted`	Mensagem validada e enfileirada para envio.
`400 - Bad Request`	Nome de `broker` inválido (campo opcional, apenas SMS/RCS).
`401 - Unauthorized`	Falha de autenticação (token ausente, inválido ou expirado).
`422 - UnprocessableEntity`	Campo obrigatório ausente ou inválido no corpo da requisição.
`409 - Conflict`	Disparo bloqueado pelo Motor de Regras — corpo traz a lista de motivos em `conflicts`.

Motor de Regras — formato de conflito (409)

Tanto a Direct Message API quanto o processamento de campanhas usam a mesma estrutura para reportar bloqueios do motor de regras:

{
  "message": "Erro na validação do Motor de Regras.",
  "errors": {},
  "record_errors": [],
  "conflicts": [
    "Domínio de e-mail bloqueado na Lista de Restrição",
    "E-mail bloqueado na Lista de Restrição"
  ],
  "requestId": "00-80016a94505f232820c73054f2ee1fa2-12c5228b9f317e12-00"
}

Para campanhas via SFTP, o mesmo tipo de motivo aparece por linha, na coluna Motivo Falha do arquivo {nome original}_EXCEPTIONS.csv — veja Uso de SFTP.

Arquivos de retorno do SFTP

Arquivo	Onde aparece	Significado
`{nome}_EXCEPTIONS.csv`	`/maestro/campaigns/processed`	Linhas do arquivo de campanha que quebraram alguma regra — coluna `Motivo Falha` explica o motivo por linha.
`{nome}_created.csv`	`/maestro/campaigns/processed`	Contatos processados, mas sem provedor configurado para o canal (não houve disparo).
`{nome}_VALIDATED.csv`	`/maestro/campaigns/processed`	Contatos processados e efetivamente disparados (havia provedor configurado).
`{nome}_errorDetail.txt`	`/maestro/campaigns/error` ou `/maestro/templates/error`	Falha no arquivo inteiro (nome fora do padrão, erro de linha em importação de template, etc.).

Veja o fluxo completo em Uso de SFTP.

Introdução

Guia do Usuário

Motor de Regras

Integrações

Central de Suporte

Códigos de Erro e Status

Status de mensagem (Webhook)

Status de template

Direct Message API — códigos HTTP

Motor de Regras — formato de conflito (409)

Arquivos de retorno do SFTP

​Status de mensagem (Webhook)

​Status de template

​Direct Message API — códigos HTTP

​Motor de Regras — formato de conflito (409)

​Arquivos de retorno do SFTP

Status de mensagem (Webhook)

Status de template

Direct Message API — códigos HTTP

Motor de Regras — formato de conflito (409)

Arquivos de retorno do SFTP