curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/template \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "phone": "+525512345678"
  },
  "template_name": "confirmacion_cita",
  "body_variables": [
    {
      "index": 1,
      "value": "Ana"
    },
    {
      "index": 2,
      "value": "10:00 AM"
    }
  ]
}
'

{
  "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 template (reabre ventana 24h)

Envía un template de WhatsApp ya aprobado por Meta. Reabre la ventana de 24h — se puede usar incluso si el cliente no ha interactuado recientemente. Este es el único tipo de mensaje que puedes enviar fuera de la ventana.

Resolución por nombre:

Se envía por template_name, no por UUID. Meta + nuestra DB enforzan unicidad de nombre por business. Si un template existe en múltiples idiomas (mismo nombre), especifica language (es_MX, en_US, etc.) — si no lo haces y hay ambigüedad la respuesta es TEMPLATE_AMBIGUOUS (409).

Nota multi-canal: el unique real en DB es (channel_configuration_id, meta_template_id, language). Si un business tiene 2+ canales WhatsApp con el mismo (name, language), la API responde TEMPLATE_AMBIGUOUS sin forma de desempate vía contrato público (este endpoint no expone channel_configuration_uuid). El servidor loguea un warn observable. Si necesitas enviar por API pública a un business multi-canal con templates duplicados, abrir issue y evaluamos ampliar el contrato.

Placeholders:

body_variables — array con {index, value} para llenar {{1}}, {{2}}, … del body. Index es 1-based y debe estar alineado con el template original.
header — si el template tiene header, se pasa aquí. Para media, usa file_uuid de un archivo ya confirmed (ver endpoints de /files/*). El servidor genera la signed URL antes de enviar a Meta.
button_parameters — solo para botones URL con placeholder dinámico ({{1}} en la URL). Los quick-reply buttons del template no llevan parámetros.

Guards aplicados:

Ventana 24h — NO aplica. El template la reabre.
Wallet general — NO aplica (paridad con el envío manual del dashboard).
Wallet visión — aplica si el header es image / video / document (el AI podría necesitarla para procesar respuestas que referencien el contenido).

POST

{slug}

conversation

messages

template

curl --request POST \
  --url https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/template \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "phone": "+525512345678"
  },
  "template_name": "confirmacion_cita",
  "body_variables": [
    {
      "index": 1,
      "value": "Ana"
    },
    {
      "index": 2,
      "value": "10:00 AM"
    }
  ]
}
'

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

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

template_name

string

requerido

Nombre del template aprobado por Meta. Debe matchear ^[a-zA-Z0-9_]+$ (alfanumérico + underscore); el servidor normaliza a lowercase per convención Meta. Único por business; si el mismo nombre existe en múltiples idiomas, la respuesta es TEMPLATE_AMBIGUOUS y debes especificar language.

Required string length: 1 - 512

Pattern: ^[a-zA-Z0-9_]+$

Ejemplo:

"promo_verano_2026"

language

string

Idioma del template (opcional). Formato Meta: 2-3 letras + opcional _ + 2-3 letras (es, es_MX, pt_BR). El servidor normaliza casing a lower_UPPER. Solo requerido si el mismo template_name existe en varios idiomas para el business.

Required string length: 2 - 10

Pattern: ^[a-zA-Z]{2,3}(_[a-zA-Z]{2,3})?$

Ejemplo:

"es_MX"

body_variables

object[]

Variables del body del template. Ordénalas por index (1-based).

Show child attributes

header

object

Header del template. Para media el cliente NO envía URLs — pasa file_uuid de un archivo previamente subido vía /files/request-upload + /files/confirm. El servidor genera una signed URL fresca al enviar.

Option 1
Option 2
Option 3
Option 4

Show child attributes

button_parameters

object[]

Parámetros para botones con placeholders dinámicos. Solo aplica a botones de tipo URL del template.

Show child attributes

Respuesta

Template enviado. wamid es el ID de Meta.

message_uuid

string<uuid>

requerido

wamid

string

requerido

ID del mensaje asignado por Meta (wa-message-id). Garantizado non-empty en envíos reales (si Meta responde sin wamid, el endpoint devuelve 502 SEND_FAILED). En conversaciones tester retorna "" por diseño — no hay envío a Meta.

Enviar quick reply (multi-message)Listar templates APPROVED del business

Introducción

Conceptos

Guías

Referencia de API

Enviar template (reabre ventana 24h)

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta