R

E

Problemas de API e integração

FAQ

FAQ

Estamos vendo um erro com os serviços de rastreamento de engajamento. Você pode ajudar?

Resolvendo problemas de rastreamento de engajamento:

  1. Problemas Comuns:

  • Erro de configuração do domínio de rastreamento

  • Problemas com o certificado SSL

  • Problemas com registros CNAME

  • Erros de validação do domínio de rastreamento


  1. Passos de Verificação:

  • Verifique a configuração do domínio de rastreamento

  • Verifique os registros CNAME

  • Valide os certificados SSL

  • Teste os links de rastreamento


  1. Passos para Resolução:

  • Revise as configurações do domínio de rastreamento na interface do usuário

  • Atualize os registros DNS se necessário

  • Verifique a validação do domínio de rastreamento

  • Verifique se há notificações de status do sistema


  1. Melhores Práticas:

  • Validação regular do domínio de rastreamento

  • Monitore métricas de engajamento

  • Configure domínios de rastreamento backup

  • Mantenha os certificados SSL atualizados

Para problemas de rastreamento persistentes, verifique a página de status e entre em contato com o suporte com mensagens de erro específicas e os domínios de rastreamento afetados.

Por que só consigo ver dados dos últimos 10 dias? Como posso armazenar dados por mais tempo?

Estratégias de retenção de dados:

  1. Retenção Padrão:

  • Métricas da UI disponíveis por um período de 10 dias

  • Os dados de eventos têm períodos de retenção específicos

  • Diferentes métricas podem ter diferentes períodos de retenção


  1. Soluções de Armazenamento a Longo Prazo:

  • Configurar webhooks para capturar dados em tempo real

  • Armazenar dados em seu próprio banco de dados

  • Usar relatórios programados para dados históricos

  • Exportar métricas importantes regularmente


  1. Melhores Práticas:

  • Implementar a coleta de dados via webhook cedo

  • Configurar exportações automatizadas

  • Considerar o uso da API de Eventos

  • Arquivar métricas importantes

Por que estou recebendo erros relacionados a permissões quando minha chave da API tem as permissões corretas?

Solucionar erros de permissão:

  1. Causas comuns:

  • Incompatibilidade de escopo da chave da API

  • Restrições de nível de acesso da conta

  • Combinações de permissão incorretas

  • Permissões alteradas recentemente ainda não propagadas

  • No caso de múltiplas contas, verifique se a chave da API corresponde à conta correta


  1. Passos de resolução:

  • Verifique novamente as permissões da chave da API na interface do usuário

  • Verifique se cada permissão requerida está explicitamente concedida

  • Assegure-se de que as permissões correspondem aos requisitos do endpoint

  • Criar nova chave de API se as permissões foram alteradas recentemente

Por que estou recebendo erros ao tentar fazer chamadas de API?

Causas comuns e soluções para erros de API:

  1. Problemas de Autenticação:

  • Verifique o formato e a validade da chave da API

  • Verifique se a chave da API está sendo passada corretamente nos cabeçalhos

  • Assegure-se de que a chave da API não expirou

  • Confirme o formato correto do cabeçalho de Autorização (Authorization: <API_KEY>)


  1. Limitação de Taxa:

  • Fique atento aos códigos de status 429

  • Implemente uma lógica de repetição adequada

  • Espaçe as solicitações de forma apropriada

  • Considere atualizar o plano se estiver alcançando limites consistentemente


  1. Formato da Solicitação:

  • Valide a sintaxe JSON

  • Verifique se os campos obrigatórios estão presentes

  • Assegure-se de que os cabeçalhos do tipo de conteúdo estão corretos

  • Verifique se as URLs de endpoint estão corretas

A person is standing at a desk while typing on a laptop.

A plataforma completa nativa de IA que escalará com o seu negócio.

© 2026 Pássaro

A person is standing at a desk while typing on a laptop.

A plataforma completa nativa de IA que escalará com o seu negócio.

© 2026 Pássaro