Saltar al contenido principal
POST
/
{slug}
/
conversation
/
ai-assistance
Solicitar asistencia AI puntual
curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance \
  --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": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Asistente de Ventas"
  },
  "instructions": "Revisa si el cliente confirmó la fecha de entrega"
}
'
{
  "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
requerido

Referencia al empleado AI. Al menos uno de uuid / name debe venir. Si se pasan ambos, prevalece name; si el name no matchea ningún empleado, cae al uuid como fallback.

​
instructions
string

Instrucciones adicionales que se pasan al empleado consultado 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:

"Revisa si el cliente confirmó la fecha de entrega"

Respuesta

Asistencia aceptada. Los guards (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

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

Opciones disponibles:
processing
Ejemplo:

"processing"