Tipos de plantilla - Insurance Boosters API

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)

Lista tus plantillas con Listar plantillas.
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
Copia name y language exactos de la plantilla listada al body del envío.
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.
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ía	Cuándo usarla
Sin variables	Plantilla fija, sin placeholders.
Variables posicionales	Body con `{{1}}`, `{{2}}`, etc.
Variables con nombre	Body con `{{nombre}}`, `{{monto}}`, etc.
Header con imagen	Imagen en el header y variables en el body.
Header con PDF	Documento PDF en el header.
Header con video	Video en el header.
Botones dinámicos	Botones 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.

​De listar a enviar (flujo recomendado)

​Ejemplo de mapeo (variables con nombre)

​Guías por escenario

De listar a enviar (flujo recomendado)

Ejemplo de mapeo (variables con nombre)

Guías por escenario