Los elementos del Agent Inbox no se están entregando
El Agent Inbox enruta elementos de trabajo desde Dailybot hacia tu stack de automatización. Cuando la entrega se detiene, los sospechosos habituales son la ruta del webhook, los toggles de funciones o los límites de tasa. Confirma cada capa de forma independiente para no perseguir un bug de cliente cuando en realidad el servidor nunca encoló el evento.
Comprobación rápida
- URL del webhook – Copia el endpoint configurado desde Dailybot y golpéalo con un payload de prueba firmado usando tu herramienta habitual (curl, Postman) si la política lo permite.
- Inbox habilitado – Verifica que la función Inbox esté activada para la organización y para el workflow o feed de agente específico que esperas.
- Headers de autenticación – Los secretos compartidos, las firmas HMAC y los bearer tokens deben coincidir con lo que tu receptor valida.
- Logs del receptor – Revisa tu servicio HTTP en busca de respuestas 4xx/5xx que Dailybot interpretaría como fallo.
- Límites de tasa – Las ráfagas de eventos de equipos grandes pueden hacer saltar los throttles de cualquiera de los dos lados.
Causas comunes y soluciones
Webhook mal configurado
Los errores de tipeo en la URL, una ruta incorrecta o una discrepancia entre HTTP y HTTPS causan fallos inmediatos. Cambia primero a un endpoint de staging conocido y bueno, luego vuelve a producción después de ver respuestas 200 en los logs de entrega de Dailybot (si están expuestos en la interfaz) o en tu gateway. Asegúrate de que las redirecciones estén permitidas o deshabilitadas; algunos clientes no siguen redirecciones de POST.
Inbox deshabilitado
Los feature flags, los cambios de facturación o los toggles accidentales apagan el Inbox sin borrar la configuración. Los admins deberían abrir los ajustes de Agent Inbox, confirmar el interruptor maestro, los interruptores por workflow y que el agente o check-in de origen siga publicando en el Inbox.
Limitación de tasa
Dailybot puede aplicar backoff cuando tu endpoint devuelve 429, o tu endpoint puede descartar mensajes cuando Dailybot envía un pico. Implementa confirmaciones 200 rápidas y encola el trabajo de forma asíncrona. Aumenta la concurrencia del receptor o consulta a soporte sobre el throughput enterprise si haces ráfagas de miles de eventos de forma habitual.
SSL o middleboxes de red
Los gateways corporativos que terminan el TLS con CAs personalizadas pueden romper las llamadas salientes de Dailybot a menos que esas CAs sean de confianza del lado de Dailybot (lo cual no es configurable por ti). De forma simétrica, si tu receptor usa un certificado autofirmado, Dailybot rechazará la conexión. Usa un certificado de confianza pública en tu endpoint o un túnel con certificados válidos para las pruebas.
Deriva del esquema del payload
Si actualizaste tu receptor para esperar campos nuevos mientras Dailybot todavía envía el esquema anterior (o viceversa), los errores de validación descartan los mensajes. Compara la documentación actual en Agent Inbox webhooks con tu parser. Registra temporalmente los cuerpos crudos en un entorno seguro para hacer el diff.
Si nada de esto funcionó
Antes de contactar a soporte, reúne:
- Nombre de la organización y nombre del workflow o inbox
- Host de la URL del webhook (no los tokens de la ruta secreta si son sensibles)
- Códigos de estado HTTP que devolvió tu servidor durante la ventana del fallo
- Si las entregas de prueba desde la interfaz de Dailybot (si está disponible) tienen éxito
- Hora aproximada de inicio y zona horaria
- Los pasos que ya probaste de este artículo
Luego contacta a soporte de Dailybot desde las opciones de Ayuda o Contacto en el producto o en el sitio web.