Saltar al contenido principal
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>"
}

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

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

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

​
button_parameters
object[]

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

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.