Integração Parou de Funcionar? Diagnóstico Rápido

Integrações podem parar de funcionar por diversos motivos: tokens expirados, mudanças de permissão ou atualizações nas plataformas conectadas. Este guia apresenta um checklist de diagnóstico rápido para que você identifique e resolva o problema o mais rápido possível.

Checklist Geral de Diagnóstico

Antes de investigar cada integração específica, execute estes passos gerais:

1. Verifique o status da integração: acesse Configurações > Integrações e confirme se a conexão está marcada como ativa
2. Reconecte a integração: desconecte e reconecte a integração, refazendo a autenticação
3. Limpe o cache do navegador: alguns problemas são causados por cache desatualizado
4. Teste em outro navegador: descarte problemas específicos do navegador
5. Verifique atualizações: confirme se não houve mudanças na plataforma integrada

Problema 1: Facebook Desconectado

Sintomas: leads do Facebook Lead Ads não chegam; mensagens do Messenger não aparecem.

Soluções:
– Acesse Configurações > Integrações > Facebook e verifique se aparece como conectado
– O Facebook exige reautenticação periódica. Clique em Reconectar e refaça o login
– Verifique se as permissões da página e da conta de anúncios não foram alteradas no Business Manager
– Confirme que seu usuário ainda é administrador da página no Facebook
– Se nada funcionar, remova a integração completamente e refaça do zero

Problema 2: Webhook Não Está Disparando

Sintomas: o sistema externo não recebe dados quando eventos acontecem na Marketek.

Soluções:
– Acesse Configurações > Integrações > Webhooks e verifique se o webhook está ativo
– Confirme que a URL de destino está correta e acessível (teste com uma ferramenta como webhook.site)
– Verifique se o evento configurado no gatilho corresponde à ação que você está testando
– Consulte os logs do webhook para identificar erros de resposta (códigos 4xx ou 5xx)
– Se o destino exige autenticação, confirme que os headers de autenticação estão corretos

Problema 3: Google Não Está Sincronizando

Sintomas: agendamentos não aparecem no Google Calendar; dados de Ads não atualizam.

Soluções:
– Acesse Configurações > Integrações > Google e verifique o status
– Tokens do Google expiram periodicamente. Clique em Reconectar
– Verifique se o calendário correto está selecionado nas configurações
– Para Google Ads, confirme que a conta de anúncios correta está vinculada
– Verifique se o perfil do Google ainda tem acesso aos recursos necessários

Problema 4: Erros no Zapier

Sintomas: Zaps param de funcionar; dados não são enviados ou recebidos.

Soluções:
– Acesse o painel do Zapier e verifique o Histórico de Tarefas para identificar erros específicos
– Reconecte a conta da Marketek no Zapier (vá em My Apps no Zapier)
– Verifique se o Zap está ativo (Zaps podem ser desligados automaticamente após muitos erros)
– Se o erro menciona “autenticação”, gere uma nova chave de API em Configurações > Integrações > API na Marketek e atualize no Zapier
– Teste o Zap manualmente usando o botão Test no editor do Zapier

Problema 5: API com Autenticação Expirada

Sintomas: requisições retornam erro 401 (Unauthorized) ou 403 (Forbidden).

Soluções:
– Gere uma nova chave de API em Configurações > Integrações > API
– Atualize a chave em todos os sistemas que utilizam a API
– Verifique se a chave de API não foi revogada acidentalmente
– Confirme que o formato do header de autenticação está correto (Bearer token)
– Teste a nova chave usando uma ferramenta como Postman ou cURL

Tabela Resumo de Diagnóstico

Quando Entrar em Contato com o Suporte

Se após seguir todos os passos acima o problema persistir, entre em contato com o suporte da Marketek com as seguintes informações:

• Nome da integração que apresenta problema
• Mensagem de erro exata (se houver)
• Data e hora em que o problema começou
• Passos já tentados para resolver
• Capturas de tela dos erros e das configurações

Isso agiliza o diagnóstico e reduz o tempo de resolução.

Artigos relacionados:
– Guia Completo: Integrações e Configurações da Marketek
– Como Integrar Facebook Lead Ads com a Marketek