Asistente IA para GoHighLevel

Contexto

Como parte de mi trabajo para Lulabotey, desarrollé un asistente empresarial conectado con GoHighLevel. La solución combina Claude con capacidades especializadas y datos operativos autorizados; no se limita a conversar, sino que interpreta una intención, consulta el contexto permitido y propone o ejecuta acciones controladas.

Trabajo realizado

Diseñé Skills pequeñas y verificables para consultar contactos, conversaciones, oportunidades, calendarios y tareas. Los Agents agrupan únicamente las capacidades necesarias para un objetivo, mientras Laravel coordina usuarios, equipos, permisos, registros y la comunicación con GoHighLevel.

Claude interpreta y planifica la solicitud, pero el servidor determina qué herramientas están disponibles, valida sus parámetros y decide qué acciones necesitan confirmación humana.

Arquitectura

• Skills: capacidades concretas, como consultar un contacto o preparar una cita.
• Agents: perfiles especializados con un objetivo y un conjunto limitado de Skills.
• Connections: credenciales, permisos y contexto aislados para cada integración.
• Laravel: autorización, validación, auditoría y comunicación segura con servicios externos.

Integración y automatización

La conexión con GoHighLevel se implementó como una capa de adaptación para que el dominio interno no dependiera directamente de las estructuras del proveedor. La solución trabaja con contactos, conversaciones, oportunidades, calendarios y tareas, conservando los identificadores externos necesarios para sincronizar cada entidad.

Los webhooks verifican el origen de los eventos y se procesan de forma idempotente. Si una operación externa falla, puede reintentarse sin duplicar contactos u oportunidades. Los registros permiten reconstruir qué evento originó cada cambio, y las APIs de Meta participan cuando una conversación comienza o continúa desde sus canales.

Diseño de conversación

El sistema diferencia entre responder, proponer y ejecutar. Una consulta informativa puede resolverse inmediatamente; una operación que modifica información se presenta antes de confirmarse. Los errores de servicios externos se convierten en mensajes claros y accionables.

Seguridad

Las instrucciones del usuario no se convierten directamente en llamadas privilegiadas. Cada herramienta valida datos, permisos y alcance. Las acciones relevantes conservan la entrada, el resultado y el responsable para permitir su auditoría. Las credenciales y los secretos nunca se incorporan al contexto visible del modelo.

Resultado

El asistente convierte lenguaje natural en operaciones de negocio verificables y reduce tareas repetitivas sin sustituir el control humano. Este caso presenta la arquitectura y los aprendizajes generales sin publicar credenciales ni datos internos de Lulabotey.