POST
/processors
Crea un processor pre-Agente que enruta leads entrantes a diferentes Agentes basado en condiciones. En lugar de especificar un workflow_id al crear un lead, envías leads al endpoint del processor y este evalúa reglas de enrutamiento para asignar el Agente correcto automáticamente.
Cada processor tiene un Agente por defecto — el fallback cuando ninguna regla de enrutamiento coincide.
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|
name | string | Sí | Nombre del processor (ej., “Language Router”) |
description | string | No | Qué hace este processor |
default_workflow_id | string (uuid) | Sí | Agente de fallback cuando ninguna regla coincide. Usa GET /workflows para listar Agentes disponibles |
Ejemplo
curl -X POST https://api.getnexor.ai/api/public/processors \
-H "Content-Type: application/json" \
-H "X-API-Key: nxr_live_your_api_key" \
-d '{
"name": "Language Router",
"description": "Routes leads to ES or EN workflows based on metadata.language",
"default_workflow_id": "uuid-of-es-workflow"
}'
Respuestas
201 — Processor creado exitosamente
{
"success": true,
"processor": {
"id": "abc-123-uuid",
"name": "Language Router",
"description": "Routes leads to ES or EN workflows based on metadata.language",
"default_workflow_id": "uuid-of-es-workflow",
"is_active": true,
"created_at": "2026-03-31T12:00:00Z",
"updated_at": "2026-03-31T12:00:00Z"
}
}
400 — Error de validación
{
"error": "Validation error",
"message": "name is required"
}
"default_workflow_id is required""default_workflow_id not found or does not belong to your account"
401 — Error de autenticación
Ver Autenticación.
500 — Error interno del servidor
Última modificación el 18 de junio de 2026
