Automatización avanzada

El hub Avanzado reúne las capacidades para conectar Nexor con otros sistemas, enrutar leads y ejecutar automatizaciones fuera del flujo conversacional normal. Se abre desde Avanzado en la barra lateral y su configuración aplica a toda la organización, salvo cuando una herramienta se asigna explícitamente a un agente.

​

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 Avanzado 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 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, cooldown y rate limit;
• 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. Simula el payload, guarda para desplegar y revisa las ejecuciones antes de activarla. Las llamadas HTTP de una prueba manual son reales aunque los cambios propuestos al lead no se apliquen. Consulta la guía completa de Cloud Functions para ver triggers, runtime, límites, ejemplos y logs.

​

Scheduled Functions

Las Scheduled Functions 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. ejecuta una prueba con credenciales y endpoints seguros; y
5. revisa los logs y diseña las escrituras para que sean idempotentes.

​

Variables de entorno

Las Variables de entorno guardan secretos compartidos por Cloud Functions, Scheduled Functions 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}}. Los valores son de solo escritura: después de guardar un secreto, la interfaz muestra el nombre pero nunca 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. Una organización puede guardar hasta 128 variables, con nombres de hasta 64 caracteres y valores de hasta 5 KiB.