# Preguntar al usuario — Whatsapp Business Cloud API

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

Envía un mensaje una image/vídeo/archivo o ambos a un chat y espera la respuesta del usuario antes de continuar.

- Acepta en las publicaciones las siguientes etiquetas HTML: b, strong , i, em, u, ins, s, strike, del, a, code, pre.
- Puedes incluir botones de tipo URL y de tipo Callback en las publicaciones.

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
- `message` *(string)* — Pregunta
- `specific_chat` *(boolean)* — Enviar la pregunta a un chat distinto
- `to_phone_number` *(string)* — Número de teléfono o Id de usuario del destinatario
- `message_type` *(string, one of: "text_message" = Mensaje de texto; "text_message_buttons" = Mensaje de texto con botones; "text_message_list" = Mensaje de texto con lista de opciones, default: "text_message")* — Número de teléfono o Id de usuario del destinatario
- `tm_multimedia` *(boolean)* — Incluir fichero multimedia
- `tm_multimedia_type` *(string, one of: "image" = Imagen; "video" = Video; "document" = Documento)*
- `tm_multimedia_url` *(string)* — URL fichero multimedia
- `tmb_header_type` *(string, one of: "header_text" = Texto; "header_multimedia" = Multimedia, default: "header_text")* — Cabecera
- `tmb_header` *(string)*
- `tmb_multimedia_type` *(string, one of: "image" = Imagen; "video" = Video; "document" = Documento)*
- `tmb_multimedia_url` *(string)* — URL fichero multimedia
- `tmb_footer` *(string)* — Comentario
- `tml_header_type` *(string, one of: "header_text" = Texto; "header_multimedia" = Multimedia, default: "header_text")* — Cabecera
- `tml_header` *(string)*
- `tml_multimedia_type` *(string, one of: "image" = Imagen; "video" = Video; "document" = Documento)*
- `tml_multimedia_url` *(string)* — URL fichero multimedia
- `tml_footer` *(string)* — Comentario
- `tml_list_title` *(string)* — Título de la lista (max. 20 caracteres)
- `reply_type` *(string, one of: "text" = El usuario deberá responder con un mensaje de texto; "image" = El usuario deberá responder enviando una imagen; "video" = El usuario deberá responder enviando un vídeo; "document" = El usuario deberá responder enviando un documento; "button" = El usuario deberá responder pulsando uno de los botones u opciones)*
- `mb_outputvars_switch` *(boolean)* — Personalizar etiquetas

Además admite grupos de campos repetibles, con estos prefijos: `mb_filters_*`, `button_value_*`, `button_text_*`, `listrow_value_*`, `listrow_text_*`, `listrow_description_*`. 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}}` *(text)* — Número de teléfono o Id de usuario. Número de teléfono o Id de usuario (BSUID) del usuario que ha respondido.
Por ejemplo: 34691000000 o US.13491208655302741918
- `{{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=
- `{{message_text}}` *(text)* — Mensaje. Mensaje contenido en la respuesta del usuario.
Por ejemplo: Hi!
- `{{media_id}}` *(text)* — Id del archivo. Id del archivo si el usuario ha respondido adjuntando uno.
Por ejemplo: 658628455733548
- `{{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/ask