Saltar al contenido principal
POST
/
{slug}
/
conversation
/
run-ai
Ejecutar empleado AI
curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/run-ai \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "whatsapp_user_id": "<string>",
    "phone": "+52 55 1234 5678"
  },
  "ai_employee": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "instructions": "Responde al cliente que el descuento aplica hasta el viernes"
}
'
{
  "conversation": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "ai_employee": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "status": "processing"
}

Documentation Index

Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt

Use this file to discover all available pages before exploring further.

Autorizaciones

​
Authorization
string
header
requerido

API token emitido desde Settings → API Token del dashboard 1TO1 AI. Enviar en header Authorization: Bearer sk_1to1_...

Parámetros de ruta

​
slug
string
requerido

Slug del business, case-insensitive. Debe coincidir con el business del token.

Ejemplo:

"acme"

Cuerpo

application/json
​
conversation
object
requerido

Identificador de la conversación — al menos UNO de los tres campos debe venir. Orden de resolución: uuid > whatsapp_user_id > phone. El lookup filtra por el business del token (defense in depth cross-tenant).

​
ai_employee
object

Empleado AI a ejecutar. Opcional: si se omite, se ejecuta el empleado asignado a la conversación. Si se pasa, ejecuta ese empleado aunque no esté asignado (transient — no cambia ai_employee_id). Acepta uuid y/o name; si pasas ambos prevalece name con fallback a uuid.

​
instructions
string

Instrucciones adicionales que se pasan al empleado además del contexto de la conversación. Min 1, max 1000 chars (whitespace al inicio/final se trimea).

Required string length: 1 - 1000
Ejemplo:

"Responde al cliente que el descuento aplica hasta el viernes"

Respuesta

Run aceptado. Los guards (ventana, wallet, visión, depth) pasaron y el empleado AI se ejecuta en background — la respuesta no espera al empleado.

​
conversation
object
requerido
​
ai_employee
object
requerido
​
status
enum<string>
requerido

El run fue aceptado y el empleado AI se ejecuta en background. La respuesta NO espera al empleado — los mensajes generados y el uso de tokens se notificarán por webhook (feature futura).

Opciones disponibles:
processing
Ejemplo:

"processing"