> ## Documentation Index
> Fetch the complete documentation index at: https://developers.insuranceboosters.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tipos de plantilla

> Guías de payload según la estructura de tu plantilla aprobada.

Estas guías te ayudan a armar el arreglo `components` del endpoint [Enviar plantilla](/whatsapp/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](/whatsapp/listar-plantillas).
2. **Identifica el escenario** según la respuesta:
   * Sin placeholders en `components` → [Sin variables](/whatsapp/enviar-plantilla/sin-variables)
   * `"parameter_format": "POSITIONAL"` o placeholders `{{1}}`, `{{2}}` → [Variables posicionales](/whatsapp/enviar-plantilla/variables-posicionales)
   * `"parameter_format": "NAMED"` o placeholders `{{nombre}}` → [Variables con nombre](/whatsapp/enviar-plantilla/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](/whatsapp/enviar-plantilla/botones-dinamicos)
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:

```json theme={null}
{
  "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):

```json theme={null}
{
  "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](/whatsapp/enviar-plantilla/sin-variables)                   | Plantilla fija, sin placeholders.           |
| [Variables posicionales](/whatsapp/enviar-plantilla/variables-posicionales) | Body con `{{1}}`, `{{2}}`, etc.             |
| [Variables con nombre](/whatsapp/enviar-plantilla/variables-con-nombre)     | Body con `{{nombre}}`, `{{monto}}`, etc.    |
| [Header con imagen](/whatsapp/enviar-plantilla/header-imagen)               | Imagen en el header y variables en el body. |
| [Header con PDF](/whatsapp/enviar-plantilla/header-pdf)                     | Documento PDF en el header.                 |
| [Header con video](/whatsapp/enviar-plantilla/header-video)                 | Video en el header.                         |
| [Botones dinámicos](/whatsapp/enviar-plantilla/botones-dinamicos)           | 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.
