Suporte

Troubleshooting

Diagnóstico rápido por código e sintoma.

Erros da Partner API

Código / sintoma	Causa provável	Correção
`invalid_instance_id`	external_customer_id enviado como UUID	Use instance_key ou UUID real
`route_not_found`	Rota ausente/incorreta	GET usa `?route=...`; POST usa body route
`partner_access_denied`	Credencial não pertence ao partner	Revise API key/JWT e recurso
`billing_access_restricted`	Assinatura past_due/restrita	Atualize o cartão e aguarde sincronização
`remote_callback_removal_failed`	Meta não removeu callback	Corrija credencial e tente novamente
`credential_not_found`	Token Meta não persistido	Faça reconnect após corrigir onboarding
`webhook_url_https_required`	URL não HTTPS	Use endpoint público com TLS válido
`template_refresh_rate_limited`	Refresh dentro do cooldown	Use cache e aguarde next_allowed_at

GET retorna health check em vez da instância

Use:

GET https://api.hookcloud.app/functions/v1/swift-worker?route=get-partner-instance&instance_id=UUID

Não use /swift-worker/get-partner-instance como formato oficial no domínio customizado.

Connect Flow não fecha

Abra o link com window.open. Navegadores podem impedir window.close() quando a página foi aberta diretamente em uma aba.

Webhook não recebe mensagens

Confira remote_callback_status=active.
Teste o GET de verificação.
Confirme que o endpoint responde 2xx.
Verifique se o app está inscrito na WABA.
Confirme o phone_number_id.
Revise firewall, TLS e redirects.

Referência: Webhook Subscriptions

Template não aparece

Confirme WABA e idioma.
Consulte sem sendable_only.
Veja o status da sincronização.
Solicite refresh uma única vez.
Confirme o template no WhatsApp Manager.

Mensagem aceita, mas não entregue

O POST pode retornar um waMID e a entrega falhar depois. Use o webhook statuses. Os erros 131049 e 131042 exigem ações diferentes; consulte Saúde de Entregas.

O que enviar ao suporte

Data/hora UTC
partner_id
instance_id / instance_key
phone_number_id
route
HTTP status
error.code e fbtrace_id
Sem tokens ou conteúdo de mensagem

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