Solução de problemas

Problema	Conferir	Ação
Link vai para destino inesperado	App/domínio, plataforma, webOnly, regras, fallback e UTMs	Simular configuração salva e conferir publicação; testar o aparelho real
Domínio pendente	Propriedade, DNS público, TLS, origem e modo/capacidade	Consultar diagnósticos e verificar novamente; não repetir criação sem conferir operação
App não abre	Identidade do pacote/bundle, association files, caminho, scheme e instalação	Consultar contrato público e validar associação no aparelho
Preview antigo	Revisão, publicação pendente, cache do cliente/plataforma	Conferir estado e resync autorizado; aguardar propagação, sem assumir atualização instantânea
Evento ausente	Intervalo/fuso, app/link, grupo, retenção, SDK e envio em segundo plano	Verificar IDs, trust e cobertura; não somar agregados históricos aos eventos
401	Credencial, sessão, expiração, revogação, ambiente	Reconectar com a conta correta
403	Permissão ou capacidade	Solicitar escopo mínimo/capacidade correta
404	Identificador ou recurso fora do dono/app	Conferir escopo; não inferir existência de recurso alheio
409	Colisão, dependência, idempotência, estado ou segredo já emitido	Consultar código e estado antes de reenviar
412 / 428	Revisão antiga ou If-Match ausente	Ler ETag atual e reconciliar; não sobrescrever cegamente
422 / 413	Campo/semântica/tamanho	Corrigir detalhes e respeitar limites UTF-8
429	Quota de credencial/conta/app	Aguardar Retry-After; trocar chave não aumenta quota compartilhada
5xx / timeout	Dependência ou resultado incerto	Consultar o recurso e preservar chave/corpo/revisão no retry

Registre somente operationId, status e requestId ao pedir suporte; não envie senha, bearer, segredo ou payload de cliente. No painel Desenvolvedores, Requisições mostra diagnóstico sanitizado e Atividade mostra mutações. Erros detalhados · Receitas · Recuperação.