Automatización avanzada

El hub Desarrolladores reúne las capacidades para conectar Nexor con otros sistemas, enrutar leads y ejecutar automatizaciones fuera del flujo conversacional normal. Abre Integraciones en la barra lateral izquierda y elige Desarrolladores. Su configuración aplica a toda la organización, salvo cuando una herramienta se asigna explícitamente a una tarea. También puedes abrir una de estas herramientas y contarle a Nexor AI qué debe hacer la primera, y él la arma.

​

Elige la capacidad correcta

​

Webhooks

Los Webhooks envían notificaciones HTTP salientes cuando ocurre un evento compatible de estado, reunión o contacto. Cada request incluye una firma HMAC en X-Nexor-Signature, por lo que el receptor puede comprobar que el payload proviene de Nexor. Úsalos cuando tu sistema solo necesita recibir el evento. Si debes filtrar, transformar, bifurcar, llamar a varios servicios o escribir datos de vuelta en el lead, usa una Cloud Function. Antes de activar un webhook:

1. configura la URL y los eventos;
2. guarda el signing secret en el sistema receptor;
3. verifica la firma sobre el body sin modificar;
4. responde rápido con un código 2xx; y
5. procesa de forma idempotente porque una entrega puede reintentarse.

Consulta Eventos de Webhooks, Verificar firmas y Reintentos y errores.

​

Herramientas MCP

Una herramienta MCP describe una llamada HTTP que el agente puede hacer durante la conversación. La definición incluye nombre, descripción, método, URL, esquema JSON de parámetros, headers, autenticación, timeout y reglas para interpretar la respuesta. Hay dos alcances:

• Catálogo global: una herramienta reutilizable que se asigna a varios agentes.
• Herramienta del agente: una integración de una sola vez, disponible únicamente para ese agente.

Después de asignarla, puedes decidir si el agente la llama cuando la necesita, si se ejecuta automáticamente al entrar el lead, si queda disponible solo en ciertas etapas o si corre como acción automática al entrar a una etapa. Consulta Herramientas del agente para estas políticas. Para administrar herramientas por API, consulta Client Tools y Workflow Tools.

​

Background Jobs

Los Background Jobs ejecutan automatizaciones estructuradas sobre leads. Pueden dispararse por cron, por un evento compatible o solo mediante la API. Un horario cron corre en la zona horaria de tu cuenta, no en UTC: 0 9 * * 1-5 corre a las 09:00 hora de tu cuenta, de lunes a viernes. Los jobs pendientes se revisan cada cinco minutos, así que una ejecución puede partir hasta cinco minutos después de la hora programada. Un job combina:

• filtros por agente, estado y datos del lead;
• condiciones sobre metadata, variables o tags;
• acciones como asignar o transferir un agente, cambiar el estado, enviar un template de WhatsApp o llamar una API externa;
• límites de leads por ciclo y cooldown;
• exclusión de leads tomados por una persona o con el agente pausado;
• modo simulación y registros por ejecución.

Empieza con Modo simulación, revisa cuántos leads serían candidatos y qué acciones se ejecutarían, y luego actívalo con límites conservadores. Usa Ejecutar ahora solo después de validar la misma configuración. Consulta la API de Background Jobs para crear, ejecutar e inspeccionar jobs de forma programática.

​

Pre-procesadores

Los Pre-procesadores enrutan leads antes de que entren a un agente. Cada procesador tiene reglas ordenadas y un agente predeterminado:

1. recibe un lead mediante el endpoint del procesador;
2. evalúa las reglas de arriba hacia abajo usando campos de primer nivel y metadata;
3. usa la primera regla que coincide; y
4. envía el lead al agente predeterminado si ninguna coincide.

Son útiles para distribuir por país, línea de negocio, campaña, producto, tamaño de cuenta o cualquier dato disponible al momento de crear el lead. El endpoint también acepta lotes; cada lead se evalúa de forma independiente y puede terminar en un agente distinto. Consulta Crear un Pre-procesador, Crear una regla y Enrutar un lead.

​

Cloud Functions

Las Cloud Functions ejecutan JavaScript aislado cuando ocurre uno de los eventos del agente. El código recibe el payload en ctx, puede consultar lead, hacer requests con axios o fetch, registrar logs, devolver JSON y proponer cambios con updateLead o updateMetadata. Cada función escucha un solo trigger. Los cambios de código quedan en un borrador que producción no ejecuta. Prueba el borrador (las lecturas se envían, las escrituras se registran pero no se envían y los cambios en el lead solo se previsualizan), publícalo y luego activa la función. Consulta la guía completa de Cloud Functions para ver triggers, runtime, límites, ejemplos y logs.

​

Funciones programadas

Las Funciones programadas ejecutan JavaScript aislado según una expresión cron y una zona horaria. En cada ejecución consultan una cohorte de leads, exponen el contexto del batch al código y registran el resultado y los logs. Úsalas cuando la lógica es demasiado específica para un Background Job: agregaciones, payloads personalizados, llamadas coordinadas a varias APIs o reglas que conviene expresar en JavaScript. Antes de activar una función:

1. define el cron y la zona horaria;
2. limita la consulta a la cohorte necesaria;
3. previsualiza los leads incluidos;
4. prueba el borrador y revisa las solicitudes que enviaría y los cambios en leads previsualizados;
5. publícalo y luego activa la función; y
6. revisa los logs y diseña las escrituras para que sean idempotentes.

Consulta la guía completa de Funciones programadas para conocer la programación, los alcances de consulta, los efectos, los borradores y versiones, las ejecuciones reales y el historial.

​

Variables de entorno

Las Variables de entorno guardan secretos compartidos por Cloud Functions, Funciones programadas y herramientas MCP. En las funciones se leen como env.NAME, por ejemplo env.CRM_API_TOKEN. En la autenticación, headers o query params de una herramienta MCP se referencian como {{env.NAME}}. El dashboard oculta los valores guardados: la lista muestra el nombre, no el valor. Reemplazar una variable exige ingresar el valor completo nuevamente. Los nombres deben comenzar con una letra mayúscula y usar solo mayúsculas, números y guiones bajos. Crear, reemplazar o eliminar una variable vuelve a desplegar cada Cloud Function y Función programada activa para mantener sus bindings actualizados. Una función en pausa toma el cambio cuando se activa. Una organización puede guardar hasta 128 variables, con nombres de hasta 64 caracteres y valores de hasta 5 KiB.