Consultar enrutador de entrada
Consulta la configuración del enrutador de entrada de un agente, su identidad compartida y las tareas entre las que puede elegir.
GET
Get inbound router
El enrutador de entrada permite que un agente elija cuál de sus tareas responde una conversación entrante nueva, según tus reglas y lo que escribe el lead. En la app aparece como Deja que tu agente elija la tarea. Consulta Tareas que trabajan juntas.
En la API, un agente es un
master_workflow y una tarea es un workflow. El ID del agente va en la ruta, y las tareas aparecen en campos como default_workflow_id y target_workflow_id.
Cómo elige la tarea
Para cada conversación nueva, el enrutador recorre estos pasos en orden y se detiene en el primero que decide. Cada paso tiene un valor delayer, que aparece en Listar decisiones.
Si algo falla en el camino, la conversación va a la tarea por defecto para que el lead igual reciba respuesta (
error_fail_open).
Antes de empezar
- El enrutador de entrada no está disponible en todas las cuentas. Sin él, todos los endpoints de esta sección responden 403
inbound_router_not_enabled. - Las claves MCP necesitan
workflows:readpara leer yworkflows:writepara hacer cambios. Las claves de API con acceso completo no necesitan nada más. - Todo cambio exige
"confirm": trueen el cuerpo. Sin eso, la API responde 400confirmation_requiredy no cambia nada. - Los errores devuelven un código estable en
error, comoagent_group_not_found. Traduce ese código a tu propio mensaje. - Para elegir qué números y casillas llegan al agente, consulta Listar puntos de entrada.
Autorizaciones
Parámetros de ruta
Respuesta
Router of the agent.
Última modificación el 28 de septiembre de 2026
Get inbound router