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>",
    "username": "@mariana.lopez",
    "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"
}
'

import requests

url = "https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance"

payload = {
    "conversation": {
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "whatsapp_user_id": "<string>",
        "username": "@mariana.lopez",
        "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"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    conversation: {
      uuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
      whatsapp_user_id: '<string>',
      username: '@mariana.lopez',
      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'
  })
};

fetch('https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'conversation' => [
        'uuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        'whatsapp_user_id' => '<string>',
        'username' => '@mariana.lopez',
        '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance"

	payload := strings.NewReader("{\n  \"conversation\": {\n    \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"whatsapp_user_id\": \"<string>\",\n    \"username\": \"@mariana.lopez\",\n    \"phone\": \"+52 55 1234 5678\"\n  },\n  \"ai_employee\": {\n    \"uuid\": \"550e8400-e29b-41d4-a716-446655440000\",\n    \"name\": \"Asistente de Ventas\"\n  },\n  \"instructions\": \"Revisa si el cliente confirmó la fecha de entrega\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conversation\": {\n    \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"whatsapp_user_id\": \"<string>\",\n    \"username\": \"@mariana.lopez\",\n    \"phone\": \"+52 55 1234 5678\"\n  },\n  \"ai_employee\": {\n    \"uuid\": \"550e8400-e29b-41d4-a716-446655440000\",\n    \"name\": \"Asistente de Ventas\"\n  },\n  \"instructions\": \"Revisa si el cliente confirmó la fecha de entrega\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversation\": {\n    \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"whatsapp_user_id\": \"<string>\",\n    \"username\": \"@mariana.lopez\",\n    \"phone\": \"+52 55 1234 5678\"\n  },\n  \"ai_employee\": {\n    \"uuid\": \"550e8400-e29b-41d4-a716-446655440000\",\n    \"name\": \"Asistente de Ventas\"\n  },\n  \"instructions\": \"Revisa si el cliente confirmó la fecha de entrega\"\n}"

response = http.request(request)
puts response.read_body

{
  "conversation": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "ai_employee": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "status": "processing"
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

Conversations

Solicitar asistencia AI puntual

Ejecuta un empleado AI como asistencia puntual sobre la conversación. El empleado consultado genera contexto/sugerencia sin tomar el hilo ni cambiar la asignación.

La conversación sigue con el empleado asignado actual (o con humano) — no se toca ai_employee_id.
No bloquea por asignación humana: si la conversación está con humano, la assistance igual corre (consulta, no respuesta al cliente).
No aplica guard de ventana 24h: el assistance no envía mensajes obligatoriamente a Meta.
Sí aplica: wallet del empleado target, visión (si hay items pending) y profundidad del grafo de action sets.

Ejecución asíncrona: los guards corren síncronos; si pasan, el endpoint responde 202 Accepted de inmediato y el empleado AI se ejecuta en background. La respuesta no espera al empleado — la ejecución con reasoning puede tardar minutos. Los mensajes generados (si los hay) y el uso de tokens se notificarán por webhook (feature futura). Si un guard falla, se responde un 4xx síncrono y el AI no se ejecuta.

Identificación del empleado: ai_employee acepta uuid y/o name. Si pasas ambos, prevalece name; si no matchea, cae al uuid como fallback.

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>",
    "username": "@mariana.lopez",
    "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"
}
'

import requests

url = "https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance"

payload = {
    "conversation": {
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "whatsapp_user_id": "<string>",
        "username": "@mariana.lopez",
        "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"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    conversation: {
      uuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
      whatsapp_user_id: '<string>',
      username: '@mariana.lopez',
      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'
  })
};

fetch('https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'conversation' => [
        'uuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        'whatsapp_user_id' => '<string>',
        'username' => '@mariana.lopez',
        '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance"

	payload := strings.NewReader("{\n  \"conversation\": {\n    \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"whatsapp_user_id\": \"<string>\",\n    \"username\": \"@mariana.lopez\",\n    \"phone\": \"+52 55 1234 5678\"\n  },\n  \"ai_employee\": {\n    \"uuid\": \"550e8400-e29b-41d4-a716-446655440000\",\n    \"name\": \"Asistente de Ventas\"\n  },\n  \"instructions\": \"Revisa si el cliente confirmó la fecha de entrega\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conversation\": {\n    \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"whatsapp_user_id\": \"<string>\",\n    \"username\": \"@mariana.lopez\",\n    \"phone\": \"+52 55 1234 5678\"\n  },\n  \"ai_employee\": {\n    \"uuid\": \"550e8400-e29b-41d4-a716-446655440000\",\n    \"name\": \"Asistente de Ventas\"\n  },\n  \"instructions\": \"Revisa si el cliente confirmó la fecha de entrega\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.1to1.ai/api/v1/public/{slug}/conversation/ai-assistance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversation\": {\n    \"uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"whatsapp_user_id\": \"<string>\",\n    \"username\": \"@mariana.lopez\",\n    \"phone\": \"+52 55 1234 5678\"\n  },\n  \"ai_employee\": {\n    \"uuid\": \"550e8400-e29b-41d4-a716-446655440000\",\n    \"name\": \"Asistente de Ventas\"\n  },\n  \"instructions\": \"Revisa si el cliente confirmó la fecha de entrega\"\n}"

response = http.request(request)
puts response.read_body

{
  "conversation": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "ai_employee": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "status": "processing"
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

{
  "code": "INVALID_API_TOKEN",
  "message": "The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token."
}

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 — exactamente UNO de los cuatro campos debe venir. Orden de resolución: uuid > whatsapp_user_id > username > phone. El lookup filtra por el business del token (defense in depth cross-tenant). Resolver por phone o username puede devolver 409 (PHONE_NUMBER_AMBIGUOUS / USERNAME_AMBIGUOUS) cuando varios contactos comparten el identificador — aplica a cualquier endpoint que acepte esta referencia.

Show child attributes

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.

Show child attributes

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

Show child attributes

ai_employee

object

requerido

Show child attributes

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"

Desasignar empleado AI de conversación Ejecutar empleado AI

Introducción

Conceptos

Guías

Referencia de API

Solicitar asistencia AI puntual

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta