Skip to content
Novo O Dailybot 3 chegou. Leia o lançamento
Solução de problemas Web Admin developer

Troubleshooting de setup de agentes (Cursor, Claude Code, Copilot, Windsurf)

Troubleshooting de setup de agentes (Cursor, Claude Code, Copilot, Windsurf)

Quando você conecta um agente de IA de programação (Cursor, Claude Code, Copilot, Windsurf, custom) ao Dailybot, três coisas precisam bater:

  1. A identidade do agente está registrada na org correta do Dailybot.
  2. O token que o agente usa é válido e não expirou.
  3. O agente está emitindo eventos que o Dailybot entende.

Se algum falhar, o dashboard mostra o agente como offline ou never reported. Esta página leva você pela escada diagnóstica.

Check rápido (2 minutos)

  1. Abra Home -> Agent dashboard na web.
  2. Encontre o agente. Estados possíveis:
Status Significado
Online Setup está bem – o problema está em outro lugar.
Offline (recente) Esteve conectado antes, não na última janela de heartbeat. Veja Heartbeat parado.
Never reported O setup nunca se completou. Continue por esta página.
Mass deactivation Muitos agentes caíram juntos – veja Mass deactivation.

Se o agente não está na lista, o registro nem criou o record.

Passo 1: confirmar a org correta

Falha bem comum: você registrou o agente na sua org pessoal / teste quando esperava que aparecesse na org da empresa.

  • No Dailybot, clique no nome da org no canto superior esquerdo – essa é a sua org atual.
  • Abra a config local do agente (Cursor settings, Claude Code settings, etc.).
  • Procure a API key ou token – compare com o que você gerou.
  • Cada token está ligado a uma org. Se você setou o agente com um token da org A, ele não vai aparecer no dashboard da B.

Regere um token na org correta e cole no agente. Veja os guias por plataforma:

Passo 2: validar o token

Sintomas de token inválido:

  • Os logs do agente mostram 401 ou 403 ao chamar o Dailybot.
  • O dashboard diz Never reported.
  • “Invalid agent token” ou similar no chat.

Correções:

  1. No Dailybot, abra Settings -> Developer / Agents -> Tokens.
  2. Confirme que o token ainda existe – podem ter revogado.
  3. Se expirou ou foi revogado, crie um novo e atualize a config do agente.
  4. Reinicie o agente para pegar o novo token.

Se seu token nunca funcionou, copie de novo com cuidado – espaços no final e caracteres faltando são a causa #1 de “invalid token”.

Passo 3: confirmar que os heartbeats estão chegando

Se o token é válido e o agente rodou, o Dailybot espera um heartbeat periódico. Se não chega:

  • Rede – o agente está em rede que bloqueia HTTPS saindo para *.dailybot.com.
  • Firewall / VPN – um firewall corporativo derruba requests. Permita os domínios do Dailybot.
  • Agente crashou em silêncio – veja os logs locais por erros não tratados.
  • Endpoint errado – config velha apontando para URL deprecada.

Para mais veja Heartbeat parado.

Passo 4: os eventos chegam mas nada acontece

Às vezes o agente está registrado e online, mas você não vê o relatório esperado.

  • Abra Home -> Agent reports – o relatório chegou?
  • Se sim mas o formato está errado, o agente manda eventos mas não os reportáveis. Veja o guia da plataforma pelos shapes exigidos.
  • Se não, veja Agent reports missing e Inbox delivery failure.

Conectando seu primeiro agente de ponta a ponta

Se você nunca conectou um agente, siga Primeiro agente. Fazer esse passo a passo uma vez geralmente revela qual etapa está quebrando.

Quando escalar para o suporte

Reúna:

  • Nome da org e seu email.
  • Qual agente (Cursor / Claude Code / Copilot / Windsurf / custom).
  • Token ID (o prefixo, não o secret).
  • Último heartbeat bem-sucedido se houver.
  • Snippet de logs locais do agente com a falha.
  • Notas de rede (VPN? proxy? firewall conhecido?).

Depois fale com o suporte do Dailybot via Ajuda / Contato no produto ou no site.

Artigos relacionados