curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/quick-reply \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "phone": "+525512345678"
  },
  "quick_reply_uuid": "1a2b3c4d-5e6f-7890-1234-567890abcdef"
}
'

{
  "messages": [
    {
      "message_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "wamid": "<string>"
    }
  ]
}

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

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

Messages

Enviar quick reply (multi-message)

Envía un quick reply configurado en el business. Un QR puede contener múltiples acciones (text, files, audio, buttons) y cada una emite un mensaje independiente a Meta — por eso la respuesta es un array con los mensajes que se generaron en orden.

Referencia al quick reply — dos formas (provee exactamente una):

quick_reply_uuid: el UUID canónico. Obtén el catálogo desde GET /quick-replies.
quick_reply: { name }: identificación por el string que el agente ve en el dashboard. Único por business case-insensitive ignorando espacios en extremos (UNIQUE (business_id, LOWER(TRIM(name)))). El match es case-insensitive (“prueba” resuelve “Prueba”). QUICK_REPLY_AMBIGUOUS queda como defense-in-depth si un hotfix afloja el unique index.

Partial success:

Si alguna de las acciones del QR falla (por ejemplo, Meta rechaza uno de los adjuntos), las otras aún se intentan. La respuesta incluye solo los mensajes que se enviaron con éxito. Si ninguno se envía, la respuesta es SEND_FAILED (502). Los mensajes fallidos quedan en audit_integration_logs + broadcast de realtime con status=failed.

Guards aplicados:

Ventana 24h — obligatoria. Si está cerrada, usa /conversation/messages/template primero para reabrirla.
Wallet general — NO aplica (paridad con el envío manual del dashboard).
Wallet visión — aplica si el QR incluye una acción files o audio (el AI podría necesitarla al procesar respuestas del cliente).

POST

{slug}

conversation

messages

quick-reply

curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/quick-reply \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "phone": "+525512345678"
  },
  "quick_reply_uuid": "1a2b3c4d-5e6f-7890-1234-567890abcdef"
}
'

{
  "messages": [
    {
      "message_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "wamid": "<string>"
    }
  ]
}

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

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

quick_reply_uuid

string<uuid>

requerido

UUID del quick reply configurado en el business. Se resuelve contra quick_replies con tenant-scope del token.

Respuesta

QR enviado. messages[] incluye uno o más mensajes según las acciones del QR.

messages

object[]

requerido

Array de mensajes emitidos por el QR (en orden). Un QR con 1 sola acción produce 1 item; con múltiples acciones (text + files + buttons) produce N items.

Show child attributes

Enviar mensaje de texto libre Enviar template (reabre ventana 24h)

Introducción

Conceptos

Guías

Referencia de API

Enviar quick reply (multi-message)

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta