Saltar al contenido principal
POST
/
{slug}
/
conversation
/
status
curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "phone": "+525512345678"
  }
}
'
{
  "conversation": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "phone": "529612864799",
    "whatsapp_user_id": "<string>"
  },
  "window": {
    "status": "open",
    "expires_at": "2023-11-07T05:31:56Z",
    "hours_remaining": 18.5
  },
  "assignment": {
    "ai_employee": {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  },
  "mailbox": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "tags": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "color": "<string>"
    }
  ],
  "inbox_status": "pending",
  "last_message": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "is_from_customer": true,
    "created_at": "2023-11-07T05:31:56Z"
  },
  "is_tester": true,
  "tester_virtual_now": "2023-11-07T05:31:56Z"
}

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

Respuesta

Snapshot del estado de la conversación.

​
conversation
object
requerido
​
window
object
requerido
​
assignment
object
requerido
​
mailbox
object
requerido
​
tags
object[]
requerido
​
inbox_status
enum<string>
requerido

Estado del inbox: pending (aún no resuelta) o resolved (cerrada por el equipo).

Opciones disponibles:
pending,
resolved
Ejemplo:

"pending"

​
last_message
object
requerido
​
is_tester
boolean
requerido

Si true, la conversación pertenece al módulo tester (ficticia). No se envían mensajes reales a Meta.

​
tester_virtual_now
string<date-time> | null
requerido

Hora virtual actual (now() + virtual_offset) — solo cuando is_tester=true. Útil para correlacionar con el dashboard del tester sin otra request.