Skip to main content
POST
Test a message
Úsalo para revisar tus reglas y umbrales antes de que escriban leads reales. No se envía ni se guarda nada: ni lead, ni conversación, ni decisión.
  • El enrutador debe estar activo (is_active: true). Si no, la API responde 400 inbound_router_inactive.
  • channel acepta whatsapp, webchat, email o api.
  • Cada llamada es un primer mensaje nuevo. Las pruebas anteriores no se recuerdan. Cuando el resultado trae clarify_question, esa es la pregunta que el agente le haría al lead.
  • Las reglas sobre phone y metadata usan el phone y la metadata que envías en el cuerpo. La prueba no envía email ni etiquetas, así que las reglas sobre email o tags no encuentran valor, y solo not_exists se cumple.
  • Las claves MCP necesitan workflows:read. La prueba no necesita confirm.

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

Agent ID (master_workflow in the API). A malformed ID returns 400 invalid_group_id.

Cuerpo

application/json
channel
enum<string>
requerido

Channel the message arrives on.

Opciones disponibles:
whatsapp,
webchat,
email,
api
first_message_text
string
requerido

The lead's first message.

Minimum string length: 1
phone
string

Optional phone number of the simulated lead. Rules on phone check this value.

metadata
object

Optional metadata of the simulated lead. Rules on metadata.<key> check these values.

Respuesta

Result of the simulation.

agent_group_id
string<uuid>
requerido
dry_run
enum<boolean>
requerido
Opciones disponibles:
true
layer
string | null
requerido

Step that decided. Same values as layer in List decisions.

action
enum<string> | null
requerido

What the AI step did: ROUTE picked a task, ASK_AGAIN asks a clarifying question, FALLBACK used the default task. null when another step decided.

Opciones disponibles:
ROUTE,
ASK_AGAIN,
FALLBACK,
null
routed_workflow_id
string<uuid> | null
requerido

Task that would answer. null while a clarifying question is pending.

routed_workflow_name
string | null
requerido
confidence
number | null
requerido
clarify_question
string | null
requerido

Question the agent would ask the lead.

max_turns_reached
boolean
requerido

true when the clarifying questions ran out and the default or best task was used.

Última modificación el 28 de septiembre de 2026