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

Lifecycle de cliente e reconnect

Código	Significado	Ação
`partner_customer_inactive`	O cliente está inativo/arquivado/mesclado.	Chame `reactivate-partner-customer` antes de gerar connect/reconnect.
`customer_deactivation_partial_failure`	Uma ou mais instâncias não concluíram o hard disconnect.	Leia `results[]`, corrija a credencial/callback e repita. Instâncias já inativas são tratadas de forma idempotente.
`meta_registration_rate_limited`	Meta 133016: muitas tentativas de registro/desregistro.	Não repita. Aguarde o cooldown informado e gere uma nova sessão.
`meta_send_access_revocation_failed`	Não foi possível garantir o bloqueio de envio.	Não considere a inativação concluída; revise token compartilhado e credencial Meta.

Notificações não aparecem

Confirme que o membro está ativo e usando JWT, não Partner API Key.
Abra Configuração e confira se a categoria está habilitada.
popup_enabled=false oculta apenas o toast; o item ainda pode aparecer no sino.
Para lembretes financeiros, confirme que o Cron da fila Stripe está ativo.
Alertas Meta de teste com IDs fictícios podem ficar sem partner e não aparecem no Portal.

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