# Ask user — Whapi

Botize method — `whapi.ask` (action).

Send a message, an image/video/document or both to a specific chat and wait for the user's response before continuing.

- The following tags are currently supported in the messages: b, strong , i, em, u, ins, s, strike, del, a, code, pre.
- You can include URL Buttons and Callback Buttons in posts.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `mb_switch` *(boolean)* — Rules
- `chat_id` *(string)* — Chat Id
- `message` *(string)* — Message
- `message_type` *(string, one of: "text_message" = Text message; "text_message_buttons" = Text message with buttons; "text_message_list" = Text message with option list, default: "text_message")* — Message
- `tm_multimedia` *(boolean)* — Include Multimedia file
- `tm_multimedia_type` *(string, one of: "image" = Image; "video" = Video; "document" = Document)*
- `tm_multimedia_url` *(string)* — Multimedia File URL
- `tmb_header_type` *(string, one of: "header_text" = Text; "header_multimedia" = Multimedia, default: "header_text")* — Header
- `tmb_header` *(string)*
- `tmb_footer` *(string)* — Footer
- `tmb_buttons_type` *(string, one of: "reply_buttons" = Buttons to track actions; "call_and_url_buttons" = Buttons linked to calls and URLs, default: "reply_buttons")* — Footer
- `button_id_1` *(string)*
- `button_text_1` *(string)*
- `button_id_2` *(string)*
- `button_text_2` *(string)*
- `button_id_3` *(string)*
- `button_text_3` *(string)*
- `call_and_url_button_text_1` *(string)*
- `call_and_url_button_type_1` *(string, one of: "url" = Redirect the user to the following URL; "call" = Call the following phone number)*
- `call_and_url_button_value_1` *(string)*
- `call_and_url_button_text_2` *(string)*
- `call_and_url_button_type_2` *(string, one of: "url" = Redirect the user to the following URL; "call" = Call the following phone number)*
- `call_and_url_button_value_2` *(string)*
- `call_and_url_button_text_3` *(string)*
- `call_and_url_button_type_3` *(string, one of: "url" = Redirect the user to the following URL; "call" = Call the following phone number)*
- `call_and_url_button_value_3` *(string)*
- `tml_header_type` *(string, one of: "header_text" = Text; "header_multimedia" = Multimedia, default: "header_text")* — Header
- `tml_header` *(string)*
- `tml_footer` *(string)* — Footer
- `tml_list_title` *(string)* — List Title
- `reply_type` *(string, one of: "text" = The user must reply by sending a text message; "image" = The user must reply by sending an image file; "video" = The user must reply by sending a video file; "document" = The user must reply by sending a document file; "button" = The user must reply by pressing one of the buttons or options offered)*
- `mb_outputvars_switch` *(boolean)* — Customize tags

It also accepts repeatable field groups, with these prefixes: `mb_filters_*`, `listrow_value_*`, `listrow_text_*`, `listrow_description_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added.

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{from_number}}` *(int)* — From Phone number. Phone number of the user who responded.
For example: 34691000000
- `{{from_name}}` *(text)* — From User Name. Name of the user who responded.
For example: Mark
- `{{message_id}}` *(int)* — Message Id. Id of the message that WhatsApp has assigned to the user's response.
For example: wamid.HBgLMzQ2BMENBNzI3NAA=
- `{{message_text}}` *(text)* — Message. Message contained in the user's response.
For example: Hi!
- `{{media_id}}` *(text)* — Media Id. File id if the user has responded by attaching one.
For example: 658628455733548
- `{{button_id}}` *(text)* — Selected Button/Option Id. Id of the selected button if the user has responded by clicking one, or Id of the selected list if the user has respond by selecting one from a list.
For example: button-1
- `{{button_title}}` *(text)* — Selected Button/Option Title. Title of the selected button if the user responded by clicking one, or Title of the selected list if the user has respond by selecting one from a list.
For example: Button 1

## Account

Needs a connected Whapi account in Botize: https://botize.com/en/app/whapi/authenticate

## This app

Every trigger and action for Whapi: https://botize.com/en/app/whapi.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/whapi/ask