# Send a text message — Whatsapp Business Cloud API

Botize method — `whatsapp_cloud_api.post_message` (action).

Send a text-based message to a phone number.

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
- `to_phone_number` *(string)* — To Phone Number or User 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_multimedia_type` *(string, one of: "image" = Image; "video" = Video; "document" = Document)*
- `tmb_multimedia_url` *(string)* — Multimedia File URL
- `tmb_footer` *(string)* — Footer
- `tml_header_type` *(string, one of: "header_text" = Text; "header_multimedia" = Multimedia, default: "header_text")* — Header
- `tml_header` *(string)*
- `tml_multimedia_type` *(string, one of: "image" = Image; "video" = Video; "document" = Document)*
- `tml_multimedia_url` *(string)* — Multimedia File URL
- `tml_footer` *(string)* — Footer
- `tml_list_title` *(string)* — List Title
- `mb_outputvars_switch` *(boolean)* — Customize tags

It also accepts repeatable field groups, with these prefixes: `mb_filters_*`, `button_value_*`, `button_text_*`, `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.

- `{{contact_id}}` *(text)* — Contact Id
- `{{message_id}}` *(text)* — Message Id

## Account

Needs a connected Whatsapp Business Cloud API account in Botize: https://botize.com/en/app/whatsapp_cloud_api/authenticate

## This app

Every trigger and action for Whatsapp Business Cloud API: https://botize.com/en/app/whatsapp_cloud_api.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/whatsapp_cloud_api/post_message