La documentación más actualizada de las APIs de Cloud Humans está en docs.cloudhumans.com/api-reference. En caso de discrepancia entre este artículo y la referencia, prevalece lo que está allí.
Cuándo usar
- Viste el aviso "Falha no envio do webhook" (Falla en el envío del webhook) en los mensajes de un ticket y quieres saber qué significa
- Quieres saber si este aviso afecta la atención o el envío de mensajes
Qué es este aviso
El aviso aparece cuando una regla de automatización de tu cuenta intenta enviar datos a un endpoint externo (webhook) y ese endpoint no confirma la recepción.
Es común en cuentas que usan automatizaciones del tipo "Mensagem recebida" (Mensaje recibido) o "Ticket resolvido" (Ticket resuelto) para enviar una copia de los datos a un sistema propio (hoja de cálculo, script, ERP, herramienta de BI).
El aviso no afecta la atención. El envío y la recepción de mensajes (incluso en WhatsApp) siguen funcionando normalmente, y la ClaudIA tampoco se ve afectada. Lo único que falla es la integración paralela que debería recibir esos datos.
Cómo investigar
- Ve a Configurações → Automação (Configuración → Automatización) e identifica las reglas que envían datos a un endpoint externo.
- Verifica la URL de destino de cada una.
- Prueba esa URL fuera de Cloud Chat: necesita responder confirmando la recepción. Si redirige (respuesta
302) o empieza a exigir inicio de sesión, el envío se considera fallido.
Caso común — Google Apps Script: la implementación debe estar configurada como "Cualquier persona tiene acceso", ejecutándose como el propietario del script. Cuando se modifica la implementación (o el enlace antiguo empieza a exigir inicio de sesión), el endpoint comienza a redirigir y todos los intentos fallan — a veces durante meses, sin que nadie lo note.
Observaciones
- Quien administra el endpoint (tu equipo o quien se encarga del script/integración) es quien necesita corregir la implementación — el ajuste no se hace en Cloud Chat.
- Si la integración ya no se usa, el camino más limpio es desactivar la regla de automatización que hace el envío, y el aviso deja de aparecer.