# Enviar plantilla de mensaje con botones — Whatsapp Business Cloud API

Método de Botize — `whatsapp_cloud_api.post_buttons_template` (acción).

Envía una plantilla de mensaje con botones a un número de teléfono.

Es una acción: ocurre como paso de una tarea. Se pueden encadenar varias.

## Campos que se configuran

Nombre interno del campo, tipo y valores admitidos. En estos campos se pueden insertar etiquetas `{{...}}` de pasos anteriores.

- `mb_switch` *(boolean)* — Reglas
- `to_phone_number` *(string)* — Número de teléfono o Id de usuario del destinatario
- `template_name` *(string)* — Nombre de la plantilla
- `template_language` *(string, one of: "en_US" = English (US); "es" = Español)* — Idioma de la plantilla
- `template_image_url` *(string)* — URL de la imagen (obsoleto, usa URL del archivo adjunto)
- `template_header_type` *(string, one of: "image" = Image; "video" = Video; "document" = Document)* — Tipo de mensaje
- `template_header_url` *(string)* — URL del archivo adjunto
- `template_header_filename` *(string)* — Nombre del archivo (sólo para documentos)

Además admite grupos de campos repetibles, con estos prefijos: `mb_filters_*`, `customparams_type_*`, `customparams_value_*`. Son componentes compuestos (botones, filtros, teclados); el número final lo pone el usuario al añadirlos.

## Variables de salida

Datos que este paso deja disponibles. Se referencian en pasos posteriores con la etiqueta entre dobles llaves.

- `{{from_number}}` *(int)* — Número de teléfono. Número de teléfono del usuario que ha respondido.
Por ejemplo: 34691000000
- `{{from_name}}` *(text)* — Nombre del usuario. Nombre del usuario que ha respondido.
Por ejemplo: Mark
- `{{message_id}}` *(int)* — Id del mensaje. Id del mensaje que WhatsApp ha asignado a la respuesta del usuario.
Por ejemplo: wamid.HBgLMzQ2BMENBNzI3NAA=
- `{{button_id}}` *(text)* — Id del botón/opción seleccionada. Id del botón seleccionado si el usuario ha respondido pulsando uno.
Por ejemplo: boton-1
- `{{button_title}}` *(text)* — Título del botón/opción seleccionada. Título del botón seleccionado si el usuario ha respondido pulsando uno.
Por ejemplo: Botón 1
- `{{user_id}}` *(text)* — Id de usuario. Identificador de usuario específico de la empresa (BSUID) que identifica al usuario de forma única. Siempre presente aunque no haya número de teléfono disponible.
Por ejemplo: US.13491208655302741918
- `{{phone_number}}` *(text)* — Número de teléfono (vacío si no disponible). Número de teléfono del usuario que ha respondido. Viene vacío cuando WhatsApp no lo facilita (usuarios con nombre de usuario o con el teléfono oculto), y en ese caso el Id de usuario es el único identificador disponible.
Por ejemplo: 34691000000

## Cuenta

Necesita una cuenta de Whatsapp Business Cloud API conectada en Botize: https://botize.com/es/app/whatsapp_cloud_api/authenticate

## Esta app

Todos los disparadores y acciones de Whatsapp Business Cloud API: https://botize.com/es/app/whatsapp_cloud_api.md

## Cómo montar esto

Un asistente de IA (Claude, ChatGPT, Cursor…) puede crear y editar estas tareas en la cuenta del usuario a través del conector MCP de Botize, incluido en todos los planes:

    https://webhook.botize.es/mcp

- Guía de conexión: https://botize.com/es/mcp
- Mapa para agentes: https://botize.com/llms.txt
- Cuenta nueva: https://botize.com/es/join (500 operaciones gratis, sin tarjeta)

---
Resumen legible por máquinas para asistentes de IA. Versión para personas: https://botize.com/es/method/whatsapp_cloud_api/post_buttons_template