API e integraciones
Triggers y Hooks
Qué son
Los triggers ejecutan acciones automáticas cuando pasa un evento.
Eventos soportados en core
after_client_createon_prospect_convertedon_task_completed
Acciones soportadas
create_tasksend_notificationfire_webhook
Dónde se configuran
En panel: configuración de triggers (core_triggers).
Ejemplo 1: crear tarea al alta de cliente
- Evento:
after_client_create - Acción:
create_task - Params sugeridos:
{
"title": "Bienvenida a {name}",
"description": "Cliente nuevo: {email}",
"priority": "media",
"status": "por_hacer"
}Ejemplo 2: notificación al convertir prospecto
- Evento:
on_prospect_converted - Acción:
send_notification
{
"type": "success",
"message": "Prospecto {prospect_name} convertido a cliente {client_name}",
"href": "router.php?view=clientes"
}Ejemplo 3: disparar webhook técnico
- Evento:
on_task_completed - Acción:
fire_webhook
{
"event": "trigger.task_completed"
}Buenas prácticas
- Empieza simple: 1 condición + 1 acción.
- Evita cadenas de automatización difíciles de depurar.
- Registra side effects en notas/log cuando sea crítico.
Errores e Idempotencia
Una integración fiable distingue entre una petición inválida, una falta de permiso y un fallo temporal. El código HTTP debe guiar la siguiente acción.
Módulos, Hooks y Mounts
NexGestion utiliza un sistema de Descubrimiento Dinámico. El Core no conoce la lógica de su módulo hasta que lee su manifiesto. Esto permite una arquitectura desacoplada y escalable.