Skip to main content
Estas guías te ayudan a armar el arreglo components del endpoint Enviar plantilla. El endpoint es siempre el mismo; lo que cambia es el payload según cómo esté construida tu plantilla.

​
De listar a enviar (flujo recomendado)

  1. Lista tus plantillas con Listar plantillas.
  2. Identifica el escenario según la respuesta:
    • Sin placeholders en components → Sin variables
    • "parameter_format": "POSITIONAL" o placeholders {{1}}, {{2}} → Variables posicionales
    • "parameter_format": "NAMED" o placeholders {{nombre}} → Variables con nombre
    • Header IMAGE / VIDEO / DOCUMENT en components → guía de header correspondiente
    • Botones con URL, quick reply o copiar código → Botones dinámicos
  3. Copia name y language exactos de la plantilla listada al body del envío.
  4. Arma components siguiendo la guía del escenario. Si la plantilla usa variables con nombre, el param_name del listado (en example.body_text_named_params) es el parameter_name del envío.
  5. Prueba en el playground de la guía: el payload viene precargado; solo completas to, name, tu API key y phoneNumberId.

​
Ejemplo de mapeo (variables con nombre)

Plantilla listada: 
{
  "name": "recordatorio_pago",
  "language": "es",
  "parameter_format": "NAMED",
  "components": [
    {
      "type": "BODY",
      "example": {
        "body_text_named_params": [
          { "param_name": "nombre", "example": "María" },
          { "param_name": "monto", "example": "$1,500" }
        ]
      }
    }
  ]
}
Payload de envío (completa to y name con tus datos): 
{
  "language": "es",
  "components": [
    {
      "type": "body",
      "parameters": [
        { "type": "text", "parameter_name": "nombre", "text": "María" },
        { "type": "text", "parameter_name": "monto", "text": "$1,500" }
      ]
    }
  ]
}

​
Guías por escenario

GuíaCuándo usarla
Sin variablesPlantilla fija, sin placeholders.
Variables posicionalesBody con {{1}}, {{2}}, etc.
Variables con nombreBody con {{nombre}}, {{monto}}, etc.
Header con imagenImagen en el header y variables en el body.
Header con PDFDocumento PDF en el header.
Header con videoVideo en el header.
Botones dinámicosBotones URL, quick reply y copiar código.
Cada guía precarga el playground con el payload completo del escenario. to y name aparecen vacíos para que uses tus datos; components ya viene armado.