# Hermoso: WhatsApp Business API: buttons, lists and forms

> Machine-readable twin of https://hermoso.ai/blog/whatsapp-business-api-buttons-lists-flows/. Generated from the shipped page. Do not edit by hand.
> Full agent guide: https://hermoso.ai/llms.txt · MCP: https://app.hermoso.ai/mcp

[Blog](https://hermoso.ai/blog/)

# WhatsApp Business API buttons, lists and forms, sent from Hermoso, ChatGPT or Claude

Send WhatsApp Business API messages with reply buttons, lists, forms, files and location requests, edit templates and set up your number, from Hermoso, ChatGPT or Claude.

By the Hermoso team · Launched November 16, 2026 · Updated November 16, 2026 · 6 min read

Your WhatsApp Business number can now send **reply buttons, pick-from-a-list menus and forms that open right inside the chat**, straight from the Hermoso inbox or from a sentence in ChatGPT or Claude. Pictures, videos, voice notes and PDFs go out the same way, and so does a button that asks someone to share their location.

Hermoso also runs the parts of the number your customers see: the business profile, the quick questions shown when a chat opens, the slash commands, and who is blocked. And when you want to know whether a message landed, it tells you what WhatsApp reported: sent, delivered, read or failed.

## What you can send now

WhatsApp lets a business send anything other than an approved template while the conversation is open, which means the person wrote to you in the last 24 hours. Inside that window, this is the menu:

You send WhatsApp's limits

Reply buttons 1 to 3 buttons, each title up to 20 characters

A list Up to 10 rows across up to 10 sections, with a text header

A link button Button words up to 20 characters and a web address, with a text, picture, video or document header

A location request The person gets a Send location button

A form (WhatsApp Flow) A published form, or a draft to test, with the words on its button

A picture JPEG, PNG or WebP, up to 5 MB

A video MP4 or 3GP, up to 16 MB

Audio AAC, AMR, MP3, M4A or OGG, up to 16 MB (a voice note is OGG)

A document PDF, Word, Excel, PowerPoint or text, up to 100 MB

Anything over a limit is refused with the limit and the count, so nothing is cut. A file is given as a link, checked against WhatsApp's list of formats and uploaded to your number before it is sent.

The answers come back readable. When someone taps a button, picks a row, shares a location or fills in a form, the inbox shows what they chose: the form's answers field by field, and the location with a map link.

## Forms inside the chat (WhatsApp Flows)

A WhatsApp Flow is a form that opens in the chat: a sign-up, a booking, a lead form, a short survey. Hermoso lists your forms, creates a draft from Meta's Flow JSON, updates it, and publishes, deprecates or deletes it. Meta's own list of problems in a form is shown as it is. Send a draft to yourself to try it before anyone else sees it.

Publishing is final, so plan for it: a published form can't be changed or deleted, only deprecated, and Meta asks for a verified business before it publishes one.

## Templates: edit them, or start from Meta's library

- **Edit a template** that is approved, rejected or paused. Meta allows an approved one to be edited up to 10 times in 30 days and once a day, and the change goes back to review. You see the change first and confirm it.

- **Meta's template library** has ready-written utility templates (order updates, appointment reminders and the like). Search it by words, topic, use case or industry and make one yours. Many are approved straight away.

Templates are what start a conversation and what a broadcast sends, so this is the half you'll use for [WhatsApp broadcasts](https://hermoso.ai/blog/whatsapp-business-broadcasts/) too.

## Your number: profile, quick questions, commands, blocking

- **Business profile:** the About line, description, address, email, up to two websites and the profile photo.

- **Quick questions (ice breakers):** up to 4, shown the first time someone opens a chat with you.

- **Commands:** up to 30, typed after a slash, each with a short hint.

- **Blocking:** WhatsApp lets a business block someone who messaged it in the last 24 hours. Each person's result is WhatsApp's own answer.

## Groups

If your number is an Official Business Account (the blue check) and isn't also running in the WhatsApp Business app, you can create groups of up to 8 people who join through an invite link. List groups and members, get or reset the link, remove people, delete a group, and send text, files or a template to the group.

## Was it delivered?

WhatsApp first only accepts a message, then reports it as sent, delivered, read or failed. Hermoso keeps those reports for 48 hours. Each of your replies in a conversation shows its status, and any message id a send or a broadcast row gave back can be looked up, with WhatsApp's own reason when a message failed. Hermoso never calls a message delivered until WhatsApp says so.

## A worked example: a dental clinic booking by WhatsApp

A small dental clinic gets a WhatsApp at 8:40 on a Monday: "Hi, can I book a cleaning this week?" The receptionist has Hermoso connected to Claude and types:

Reply to Maria on WhatsApp: "Happy to help! Which suits you?" with three buttons: Tue 9:00, Wed 14:30, Call me.

Claude shows the message with its three buttons and sends it on a yes. Maria taps **Wed 14:30**, and the conversation in the inbox shows that choice. The receptionist follows up with the clinic's new-patient form as a PDF and asks Claude whether it was delivered. A few minutes later the report reads **read**.

That evening the clinic owner asks Claude to find an appointment reminder in Meta's template library and make it theirs for next week's reminders. Then, under Settings beside WhatsApp, she sets four quick questions on the number: "Book a cleaning", "Opening hours", "Do you take my insurance?" and "Emergency appointment".

A WhatsApp conversation in the Hermoso inbox: reply with text, or open "Add buttons, a link, a file or a location request". Demo brand data.

## Set it up in the app

- **Connect WhatsApp** under Connectors to set up a number through Meta's own signup, or connect Meta and tick the WhatsApp Business Account you already manage. One is enough. [Connect WhatsApp in Hermoso](https://app.hermoso.ai/?src=blog-whatsapp-business-api-buttons-lists-flows&connect=whatsapp).

- **Open Automations, then Inbox,** and open a conversation.

- **Under the reply box, use "Add buttons, a link, a file or a location request"** to build the message.

- **Press Settings beside WhatsApp** in the inbox for the profile, quick questions, commands and blocked people.

## Or ask ChatGPT or Claude

With Hermoso connected to ChatGPT or Claude, one sentence does it: Send Maria a WhatsApp list of our three cleaning packages with prices, then tell me when she's read it. The agent uses the same tools as the app: `send_whatsapp_message`, `read_whatsapp_inbox`, `list_whatsapp_templates`, `create_whatsapp_template`, `manage_whatsapp_number`, `manage_whatsapp_flow` and `send_whatsapp_broadcast`. Anything that reaches a person or changes what customers see is shown to you first and runs when you confirm.

All of these cost no credits in Hermoso. Meta bills your business for delivered template messages at its own rates.

## More

Every limit and parameter is in the [WhatsApp docs](https://hermoso.ai/docs/whatsapp/). The channel overview is on the [WhatsApp page](https://hermoso.ai/channels/whatsapp/), and the short version is in the [changelog](https://hermoso.ai/changelog/whatsapp-business-api-buttons-lists-flows/). To do it from a chat, add Hermoso to [ChatGPT](https://hermoso.ai/chatgpt/) or [Claude](https://hermoso.ai/claude/).

## Questions people ask

### Can I send buttons and lists with the WhatsApp Business API?

Yes. Inside the 24-hour window you can send 1 to 3 reply buttons, a list of up to 10 rows, a link button, a location request or a form, and Hermoso shows which one the person picked.

### What are WhatsApp Flows?

Forms that open inside the WhatsApp chat, such as a booking, a sign-up or a survey. Hermoso creates, tests, publishes and deprecates them, and shows the answers field by field in the inbox.

### Can I edit an approved WhatsApp template?

Yes. Meta allows an approved template to be edited up to 10 times in 30 days and once a day, and the edit goes back to review.

### How do I know if a WhatsApp message was delivered?

WhatsApp reports each message as sent, delivered, read or failed. Hermoso keeps those reports for 48 hours and shows them on each reply, or for any message id you look up.

### Can a business create WhatsApp groups?

Yes, if the number is an Official Business Account and not also running in the WhatsApp Business app. A group holds up to 8 people, who join through its invite link.
