Saltar al contenido principal

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.

Una plantilla es un mensaje preaprobado por Meta. Es el único tipo de mensaje que puedes enviar cuando la ventana de 24 horas está cerrada — es decir, cuando el contacto no te escribió en las últimas 24 horas. Mientras la ventana está abierta puedes enviar texto libre; una vez cerrada, solo una plantilla llega al cliente.
Las plantillas se crean y se aprueban en el dashboard. La API pública solo las consume para enviar — no las crea ni las edita.

​
Cómo se resuelve una plantilla

1

Identifica la plantilla por nombre

Una plantilla se identifica por su template_name — el mismo nombre que ves en el dashboard y que reportas a Meta.
2

Especifica el idioma si hace falta

Si el mismo nombre está aprobado en varios idiomas, agrega language (formato Meta lower_UPPER, ej. es_MX) para elegir cuál enviar. Si solo existe en un idioma, es opcional.
3

Verifica que esté aprobada

Solo se pueden enviar plantillas en estado APPROVED. Una en PENDING o REJECTED no es enviable.

​
Componentes de una plantilla

Al enviar una plantilla rellenas sus partes dinámicas:

body_variables

Los placeholders del cuerpo ({{1}}, {{2}}, …). Array de objetos { index, value }.

header

El encabezado: texto, o media vía file_uuid.

button_parameters

Parámetros de botones dinámicos (ej. el sufijo de un botón URL).

​
Enviar una plantilla

Un envío típico, con dos variables en el cuerpo: 
curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/template" \
  -H "Authorization: Bearer sk_1to1_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": { "phone": "+5215512345678" },
    "template_name": "confirmacion_cita",
    "language": "es_MX",
    "body_variables": [
      { "index": 1, "value": "Ana" },
      { "index": 2, "value": "10:00 AM" }
    ]
  }'
Para descubrir qué plantillas tienes disponibles y qué variables espera cada una, consulta los endpoints de catálogo de plantillas en la Referencia de API.

​
Próximos pasos

Enviar mensajes

El envío de plantillas, texto, media y quick replies.

Conversaciones

La ventana de 24 horas y el estado de una conversación.