WhatsApp Business
Hermoso connects your WhatsApp Business number, keeps the last 48 hours of each conversation in your inbox, and sends from your number: approved templates to start a conversation, and inside the 24-hour window anything WhatsApp allows, from plain text to buttons, lists, files and forms. It also manages the parts of the number your customers see.
Connect
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. Every tool below only reaches the accounts and numbers shared with the brand you are working in.
Messages beyond text
WhatsApp lets a business send anything other than a template only while the 24-hour window is open: someone wrote to you in the last 24 hours. Hermoso refuses a message to someone whose window it knows has closed, for free, and says to use a template. In the inbox the same rule applies to replies.
| You send | WhatsApp's limits |
|---|---|
| Reply buttons | 1 to 3 buttons, each title up to 20 characters and different; body up to 1,024 |
| A list | Up to 10 rows across up to 10 sections; row title 24, description 72; the button 20; body up to 4,096; a text header only |
| A link button | Button words up to 20, a web address; a text, picture, video or document header |
| A location request | Body up to 1,024; 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, caption up to 1,024 |
| A video | MP4 or 3GP, up to 16 MB |
| Audio | AAC, AMR, MP3, M4A or OGG, up to 16 MB; a voice note must be OGG (OPUS) |
| A document | PDF, Word, Excel, PowerPoint or text, up to 100 MB |
Anything over a limit is refused with the limit and the count. Nothing is cut. A file is given as a public link; Hermoso checks it against WhatsApp's list and uploads it to your number first.
- In the app: open a conversation in the Inbox and use "Add buttons, a link, a file or a location request" under the reply box.
- From an agent:
send_whatsapp_messagewithinteractiveormedia, orread_whatsapp_inboxwith a conversation andinteractiveormedia.
When someone taps a button, picks from a list, 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.
Was it delivered?
When a message is sent, WhatsApp first only accepts it. It then reports each message as sent, delivered, read or failed, and Hermoso keeps those reports for 48 hours. Pass the message id a send or a broadcast row gave back to read_whatsapp_inbox as messageId to see the latest one, including WhatsApp's own reason when a message failed. In a conversation, each of your replies shows its status. Until WhatsApp reports a message as delivered, Hermoso never says it was.
Templates: edit, and Meta's library
- Edit.
create_whatsapp_templatewithedit: truechanges an existing template. Meta lets you edit one that is approved, rejected or paused; an approved one up to 10 times in 30 days and once a day, and the change goes back to review. The new components replace all the old ones. The first call shows the change; a second withconfirm: truemakes it. - Meta's library.
list_whatsapp_templateswithlibrary: truelists Meta's pre-written utility templates (search by words, topic, use case or industry).create_whatsapp_templatewithlibraryTemplateNamemakes one yours; many are approved straight away.
Your number: profile, quick questions, commands, blocked people
In the app, open the Inbox and press Settings beside WhatsApp. From an agent, manage_whatsapp_number.
| Setting | WhatsApp's limits |
|---|---|
| About | 1 to 139 characters |
| Description, address, email | 512, 256 and 128 characters |
| Websites | Up to 2, each starting with http:// or https:// |
| Profile photo | A JPEG or PNG link |
| Quick questions (ice breakers) | Up to 4, up to 80 characters, no emoji; shown the first time someone opens a chat |
| Commands | Up to 30, typed after /; name up to 32, hint up to 256, no emoji |
WhatsApp only lets a business block someone who messaged it in the last 24 hours. A blocked person cannot message you, and you cannot message them. Each person's result is WhatsApp's own answer.
Forms (WhatsApp Flows)
A form opens inside the chat: sign-up, booking, a lead form, a survey. manage_whatsapp_flow lists them, creates a draft from Meta's Flow JSON, updates a draft, and publishes, deprecates or deletes. Meta's own list of problems in a form is shown as it is. Publishing is final: a published form cannot be changed or deleted, only deprecated, and Meta asks for a verified business before it publishes one. Send a draft to yourself with mode draft to test it.
Groups
WhatsApp groups are for an Official Business Account (the blue check), and not for a number that also runs in the WhatsApp Business app. A group holds up to 8 people, who join only through its invite link. With manage_whatsapp_number you can list groups, see members, create one, get or reset the invite link, remove people and delete a group; send to a group with send_whatsapp_message and groupId (text, files or a template, not buttons). Removing people, resetting the link and deleting ask for a second confirmed call.
The tools
| Tool | What it does |
|---|---|
send_whatsapp_message | A template, text, buttons, a list, a link button, a location request, a form or a file, to a person or a group |
read_whatsapp_inbox | Read conversations, reply with text, buttons or a file, and check one sent message's delivery (messageId) |
list_whatsapp_templates, create_whatsapp_template, delete_whatsapp_template | Your templates and Meta's library: create, edit, delete |
manage_whatsapp_number | The profile, quick questions, commands, blocked people and groups of one number |
manage_whatsapp_flow | WhatsApp forms: create, edit, publish, deprecate, delete |
send_whatsapp_broadcast | One template to many people |
All of them are free in Hermoso. Meta bills your business for delivered template messages at its own rates. Everything that reaches a person or changes what customers see is confirm-gated on every surface.