Skip to main content
POST
Si workflow_id apunta a una tarea activa, Nexor empieza a contactar al lead de inmediato. Normalmente ocurre según su cadencia (WhatsApp, llamadas y otros canales); las llamadas esperan el horario de contacto de la tarea, y los mensajes salen de inmediato salvo que la tarea los restrinja a su horario; force_touchpoint: true ignora el horario y contacta de inmediato. No se contacta a los leads marcados como no contactar, y las tareas que solo responden (solo entrantes) no inician contacto. Si la tarea está en pausa, el contacto empieza cuando la actives.
Esto mueve el lead a otro agente de IA (workflow). No cambia el responsable del lead — la persona de tu equipo a cargo de él.Para definir el responsable, envía assigned_to en PATCH /leads/ o al crear el lead.

​
Solicitar una llamada inmediata

Envía force_touchpoint: true cuando un lead solicite una llamada ahora, incluso fuera del horario de contacto del agente:
En una asignación nueva, el agente selecciona primero el canal de llamadas si está disponible y programa la llamada inicial sin esperar al horario de contacto. Los contactos posteriores conservan sus horarios configurados. Si el lead ya está activo en este agente, la llamada se solicita sobre la asignación existente sin reiniciar su etapa. Usa restart: true solo si también necesitas una asignación nueva. El parámetro respeta las pausas, los canales de llamada desactivados, la intervención humana, los leads que esperan a alguien de tu equipo y la protección contra llamadas duplicadas. Si la llamada inicial no está disponible, puede aplicarse la alternativa de canal habitual; la solicitud de llamada inmediata se informa como no aplicada. Revisa el objeto force_touchpoint de la respuesta:
applied: true significa que la llamada se programó o fue aceptada, no que el lead contestó. Si devuelve applied: false, revisa reason, code o error para conocer la causa. Por ejemplo, workflow_paused indica que el agente está pausado, duplicate_lead_call indica que una llamada existente bloqueó una nueva y lead_in_support indica que el lead está esperando una respuesta de alguien de tu equipo. lead_support_unverified con retryable: true indica que Nexor no pudo confirmar si el lead está esperando al equipo; la solicitud se puede reintentar tras una breve espera. La asignación puede devolver success: true junto con force_touchpoint.applied: false. La opción tiene el valor predeterminado false y solo acepta un booleano JSON. Las claves MCP necesitan leads:write y messages:send; las claves REST mantienen su acceso habitual. La opción solo aplica a este endpoint de asignación individual, no a la asignación masiva ni a la creación de leads.

Autorizaciones

​
X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de ruta

​
id
string<uuid>
requerido

Lead ID

Cuerpo

application/json
​
workflow_id
string<uuid>
requerido

ID of the workflow to assign the lead to. Use GET /workflows to list available workflows. workflowId (camelCase) is accepted as an alias.

Ejemplo:

"123e4567-e89b-12d3-a456-426614174000"

​
reason
string

Optional reason for the assignment. Stored on the deactivated workflow run when reassigning.

Ejemplo:

"Lead qualified for premium workflow"

​
restart
boolean
predeterminado:false

Create a fresh run even if the lead is already active in this Agent. When omitted or false, the existing run and stage are preserved.

​
force_touchpoint
boolean
predeterminado:false

Request an immediate call, including outside contact hours. On a new run, selects call as the opening channel when available and bypasses hours only for that call; normal channel fallback remains when calling is unavailable. On an existing run, requests a call without restarting it. Pauses, channel availability and outbound guards remain in effect. MCP keys require messages:send in addition to leads:write.

Respuesta

Workflow assigned successfully

​
success
boolean
requerido
​
workflow_run
object
requerido
​
force_touchpoint
object

Present when force_touchpoint is true. Assignment may succeed while the call request is blocked or fails. applied=true means the call was queued or accepted, not that the lead answered.

Última modificación el 6 de octubre de 2026