Ejecutar empleado AI

Endpoint · POST /conversation/actions

Ejecuta un empleado AI. ai_employee es opcional — sin él usa el asignado a la conversación. instructions es opcional. Campos

ai_employee — { name } del empleado AI (opcional; sin él usa el asignado a la conversación).
instructions — texto libre (opcional).

{
  "type": "run_ai",
  "ai_employee": { "name": "Agente Ventas" },
  "instructions": "Ofrece un 10% de descuento y confirma el horario de entrega"
}

// sin ai_employee: usa el empleado AI asignado a la conversación
{
  "type": "run_ai"
}

En una lista, este objeto va en el array actions de un POST /conversation/actions — ver Armar una lista de acciones.

Ejemplo ejecutable

Un run_ai sobre una conversación identificada por teléfono y canal. Con ai_employee corre un empleado explícito; sin él, corre el empleado AI asignado a la conversación. instructions es opcional.

Request

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "run_ai",
        "ai_employee": { "name": "Agente Ventas" },
        "instructions": "Ofrece un 10% de descuento y confirma el horario de entrega"
      }
    ]
  }'

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "run_ai"
      }
    ]
  }'

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).

{
  "status": "processing",
  "actions_accepted": 1
}

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.

Introducción

Conceptos

Guías

Acciones

Ejemplo ejecutable

Request

Respuesta

​Ejemplo ejecutable

​Request

​Respuesta

Ejemplo ejecutable

Request

Respuesta