Saltar al contenido principal
POST
/
{slug}
/
conversation
/
scheduled-message
curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/scheduled-message \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "executor_kind": "ai_employee",
  "conversation": {
    "phone": "+52 55 1234 5678"
  },
  "schedule_at": {
    "date": "2026-06-15",
    "time": "14:30"
  },
  "reason": "Seguimiento del cliente tras la propuesta"
}
'
{
  "data": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "schedule_at": "2023-11-07T05:31:56Z",
    "status": "pending"
  }
}

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
​
executor_kind
enum<string>
requerido
Opciones disponibles:
ai_employee
​
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).

​
schedule_at
object
requerido

Fecha + hora interpretadas en la zona horaria del negocio (businesses.timezone, configurada al onboarding — típicamente America/Mexico_City). El servidor combina ambos campos contra esa zona para construir el instante UTC. La response normaliza a ISO Z (UTC).

​
reason
string
requerido

Motivo del programado. Se inyecta como context_note en la conversación al firing.

Required string length: 1 - 500
​
scheduled_uuid
string<uuid>

UUID pre-generado client-side (opcional). Reservado para uso futuro — el flow de pre-subir archivos referenciando el UUID antes del POST todavía no está disponible en API pública (sí en dashboard). Si lo omitís, el servidor genera el UUID automáticamente; si lo enviás, se respeta vía COALESCE en el RPC.

​
ai_employee_uuid
string<uuid> | null

UUID del AI employee. Si null/omitido, usa el AI asignado a la conversación. Si la conv no tiene AI asignado y no lo pasás, falla con NO_AI_EMPLOYEE_ASSIGNED.

​
template_uuid
string<uuid> | null

Template fallback. Si omitido, el firing usa el default scheduled template del canal (auto-creado al configurar WhatsApp).

Respuesta

Schedule creado.

​
data
object
requerido