Operação

Saúde de Entregas

Como as mensagens chegam diretamente ao webhook do partner, o seu backend reporta status normalizados para a HookCloud.

O que reportar

Estratégia	Volume	Métricas disponíveis
Somente falhas	Baixo	Erros, alertas e causas
Estados finais	Médio	Entregue, lido e falhou
Todos os estados	Maior	Funil completo accepted → read

Reportar status

curl --request POST 'https://api.hookcloud.app/functions/v1/swift-worker' \
  --header 'apikey: SUA_PUBLISHABLE_KEY' \
  --header 'Authorization: Bearer hc_partner_live_SUA_CHAVE' \
  --header 'Content-Type: application/json' \
  --data '{
    "route": "report-partner-message-status",
    "phone_number_id": "PHONE_NUMBER_ID",
    "message_id": "wamid.xxxxx",
    "status": "delivered",
    "template_name": "confirmacao_agendamento",
    "template_language": "pt_BR",
    "campaign_id": "campanha_456",
    "occurred_at": "2026-07-21T12:00:00Z"
  }'

131049 — healthy ecosystem engagement

131049

Mensagem não entregue para preservar o engajamento saudável

É comum em envios de marketing. Não significa necessariamente falha técnica do número.

Não faça retentativa automática imediata.
Aguarde ao menos 24 horas para nova tentativa manual.
Revise opt-in, segmentação, frequência e engajamento recente.
Não alterne números para contornar a proteção.

{
  "route": "report-partner-message-delivery-failure",
  "phone_number_id": "PHONE_NUMBER_ID",
  "message_id": "wamid.xxxxx",
  "client_message_id": "msg_local_123",
  "template_name": "campanha_marketing",
  "campaign_id": "campanha_456",
  "error_code": 131049,
  "error_title": "This message was not delivered to maintain a healthy ecosystem engagement",
  "error_message": "Detalhe retornado pela Meta",
  "recipient_hash": "HMAC_SHA256_HEX_COM_64_CARACTERES",
  "occurred_at": "2026-07-21T12:00:00Z"
}

131042 — pagamento da WABA na Meta

131042

Business eligibility / payment issue

É um problema da conta WhatsApp na Meta, não da assinatura Stripe da HookCloud.

Verifique cartão cadastrado no WhatsApp Manager.
Verifique linha de crédito e conta de pagamento.
Regularize restrições financeiras antes de reenviar.
Use client_message_id quando a falha ocorrer antes do waMID.

Outros códigos classificados

Código	Classificação	Ação sugerida
131026	message_undeliverable	Validar destino e disponibilidade
131031	account_locked	Revisar bloqueio da conta
131047	re_engagement_required	Retomar com template adequado
131048	spam_rate_limit	Reduzir frequência
131050	marketing_opt_out	Respeitar opt-out
131056	pair_rate_limit	Aguardar antes de novo envio
130429 / 80007	waba_rate_limit	Reduzir concorrência e aplicar backoff
131016	meta_service_unavailable	Retry exponencial
132000	template_parameter_mismatch	Corrigir parâmetros
132001	template_not_found_or_unavailable	Reconciliar catálogo
132015	template_paused	Remover de campanhas
130472	marketing_experiment	Tratar como restrição de marketing

Consultar métricas

GET https://api.hookcloud.app/functions/v1/swift-worker?route=get-partner-delivery-health&window_hours=24

Retorna totais, taxa de falha, contagens 131049/131042, top erros, top templates e alertas abertos.

Privacidade

Não envie conteúdo da mensagem
Não envie nome do destinatário
Não envie telefone em texto puro
Use HMAC-SHA256 em recipient_hash
Envie somente metadados técnicos necessários

Esta página ajudou?Use o Partner Portal para suporte e compartilhe o link desta seção.