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"
}

{
  "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

Estado puntual de una conversación

Devuelve el estado público de una conversación: ventana 24h, asignación, buzón, tags, inbox_status y último mensaje. Operación de lectura pura — idempotente, sin side effects.

Campos clave:

window.status — "open" si puedes enviar mensajes libres; "closed" si necesitas template primero.
assignment.type — "ai_employee" cuando hay AI asignado (ai_employee_id !== null); "human" cuando la conversación es atendida por humano (ai_employee_id === null). Un inbox_status === "pending" no bloquea la ejecución AI desde la API (/run-ai, /ai-employee run=true y /ai-assistance corren bajo responsabilidad del caller). Para dejar la conversación en "human" usa POST /conversation/unassign-ai.
mailbox — null si la conversación no tiene buzón asignado.
tags — lista de etiquetas vigentes (sin las soft-deleted).
is_tester — true en conversaciones del módulo tester. El servidor respeta el reloj virtual (tester_virtual_now) al calcular hours_remaining.

POST (no GET) — la conversación se identifica por body (phone / whatsapp_user_id / username / uuid) siguiendo la convención de /conversation/*. El endpoint NO muta nada; el audit queda con read_conversation_status para trazar quién consulta qué.

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"
}

{
  "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

Respuesta

Snapshot del estado de la conversación.

conversation

object

requerido

Show child attributes

window

object

requerido

Show child attributes

assignment

object

requerido

Show child attributes

mailbox

object | null

requerido

Show child attributes

Introducción

Conceptos

Guías

Referencia de API

Estado puntual de una conversación

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta