Asignar tag a conversación

curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "phone": "+525512345678"
  },
  "tag_name": "VIP"
}
'

{
  "conversation_tag_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tag": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "color": "#FFB300"
  }
}

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

POST

{slug}

conversation

tags

curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "phone": "+525512345678"
  },
  "tag_name": "VIP"
}
'

{
  "conversation_tag_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tag": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "color": "#FFB300"
  }
}

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

Option 1
Option 2

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

tag_uuid

string<uuid>

requerido

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

Respuesta

Tag asignado

conversation_tag_uuid

string<uuid>

requerido

tag

object

requerido

Show child attributes

Reabrir handoff humano (marcar pendiente)Remover tag de conversación

Introducción

Conceptos

Guías

Referencia de API

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta