Skip to main content
Endpoint · POST /conversation/actions
ai_assistance ejecuta el empleado AI que elijas sobre la conversación sin asignarlo. Es una ejecución puntual: el empleado corre de forma transitoria y genera su asistencia (contexto/sugerencia) sobre la conversación, pero no se convierte en el empleado asignado — la conversación sigue con quien la atiende (otro empleado AI o un humano) y la asignación no cambia. Cómo se diferencia de las otras acciones de AI:
  • run_ai ejecuta al empleado asignado —el que atiende— y toma el turno.
  • assign_ai_employee cambia qué empleado atiende la conversación.
  • ai_assistance ejecuta a otro empleado sin asignarlo — su salida no cambia quién atiende.
Campos
  • ai_employee — { name } del empleado AI a consultar (obligatorio).
  • instructions — texto opcional con la consulta o el foco para el empleado (por ejemplo, “¿Este cliente califica para el plan empresarial?”).
Consume tokens del modelo del empleado consultado y cuenta como acción que dispara AI (máximo 3 por grupo). En una lista, este objeto va en el array actions de un POST /conversation/actions — ver Armar una lista de acciones.

​
Ejemplo ejecutable

Un ai_assistance sobre una conversación identificada por teléfono y canal: ejecuta de forma puntual al empleado AI elegido, sin cambiar la asignación de la conversación.

​
Request

​
Respuesta

202 Accepted — el grupo se aceptó y corre en background. El resultado real por acción no viaja en la respuesta (se consulta después — ver Cómo se ejecuta).
​
string
Siempre processing: confirma que el grupo fue aceptado y está en ejecución.
​
integer
Cuántas acciones del array se admitieron para ejecución — no cuántas tuvieron éxito.