Skip to content
Nuevo Dailybot 3 ya está aquí. Lee el lanzamiento
Solución 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)

Cuando conectás un agente de IA de programación (Cursor, Claude Code, Copilot, Windsurf, custom) con Dailybot, tres cosas tienen que coincidir:

  1. La identidad del agente está registrada en la org correcta de Dailybot.
  2. El token que el agente usa es válido y no expiró.
  3. El agente está emitiendo eventos que Dailybot entiende.

Si alguno falla, el dashboard muestra el agente como offline o never reported. Esta página te lleva por la escalera diagnóstica.

Check rápido (2 minutos)

  1. Abrí Home -> Agent dashboard en la web.
  2. Encontrá el agente. Estados posibles:
Estado Significado
Online El setup está bien – el problema está en otro lado.
Offline (recientemente) Estuvo conectado antes, no en la última ventana de heartbeat. Ver Heartbeat detenido.
Never reported El setup nunca se completó. Continuá con esta página.
Mass deactivation Muchos agentes se cayeron a la vez – ver Mass deactivation.

Si el agente no está en la lista, el registro ni siquiera creó el record.

Paso 1: confirmar la org correcta

Falla muy común: registraste el agente en tu org personal / test cuando esperabas que apareciera en la org de la empresa.

  • En Dailybot, clic en el nombre de org arriba a la izquierda – esa es tu org actual.
  • Abrí la config local del agente (Cursor settings, Claude Code settings, etc.).
  • Buscá la API key o token – compará con el que generaste.
  • Cada token está atado a una org. Si configuraste el agente con un token de org A, no va a aparecer en el dashboard de B.

Regenerá un token en la org correcta y re-pegalo en el agente. Ver las guías por plataforma:

Paso 2: validar el token

Síntomas de token inválido:

  • Los logs del agente muestran 401 o 403 al llamar a Dailybot.
  • El dashboard dice Never reported.
  • “Invalid agent token” o similar en el chat.

Fixes:

  1. En Dailybot, abrí Settings -> Developer / Agents -> Tokens.
  2. Confirmá que el token aún existe – pueden haberlo revocado.
  3. Si expiró o fue revocado, creá uno nuevo y actualizá la config del agente.
  4. Reiniciá el agente para que tome el nuevo token.

Si tu token nunca funcionó, copialo de nuevo con cuidado – espacios al final y caracteres faltantes son la causa #1 de “invalid token”.

Paso 3: confirmar que los heartbeats llegan

Si el token es válido y el agente corrió, Dailybot espera un heartbeat periódico. Si no llega:

  • Red – el agente está en una red que bloquea HTTPS saliente a *.dailybot.com.
  • Firewall / VPN – un firewall corporativo descarta requests. Allowlistá los dominios de Dailybot.
  • Agente crasheó en silencio – revisá los logs locales por errores no manejados.
  • Endpoint equivocado – una config vieja apunta a una URL deprecada.

Para más ver Heartbeat detenido.

Paso 4: los eventos llegan pero no pasa nada

A veces el agente está registrado y online, pero no ves el reporte esperado.

  • Abrí Home -> Agent reports – ¿el reporte llegó?
  • Si sí pero el formato está mal, el agente manda eventos pero no los reportables. Chequeá la guía de la plataforma por los shapes requeridos.
  • Si no, ver Agent reports missing y Inbox delivery failure.

Conectar tu primer agente de punta a punta

Si nunca conectaste un agente, seguí Primer agente. Hacer ese walkthrough una vez suele revelar qué paso te falla.

Cuándo escalar a soporte

Junta:

  • Nombre de org y tu email.
  • Cuál agente (Cursor / Claude Code / Copilot / Windsurf / custom).
  • Token ID (el prefijo, no el secret).
  • Último heartbeat exitoso si hay.
  • Snippet de logs locales del agente con el fallo.
  • Notas de red (VPN? proxy? firewall conocido?).

Luego escribí a soporte desde Ayuda / Contacto en el producto o en la web.

Artículos relacionados