hermosodocs

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 sendWhatsApp's limits
Reply buttons1 to 3 buttons, each title up to 20 characters and different; body up to 1,024
A listUp 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 buttonButton words up to 20, a web address; a text, picture, video or document header
A location requestBody 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 pictureJPEG, PNG or WebP, up to 5 MB, caption up to 1,024
A videoMP4 or 3GP, up to 16 MB
AudioAAC, AMR, MP3, M4A or OGG, up to 16 MB; a voice note must be OGG (OPUS)
A documentPDF, 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.

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

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.

SettingWhatsApp's limits
About1 to 139 characters
Description, address, email512, 256 and 128 characters
WebsitesUp to 2, each starting with http:// or https://
Profile photoA 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
CommandsUp 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

ToolWhat it does
send_whatsapp_messageA template, text, buttons, a list, a link button, a location request, a form or a file, to a person or a group
read_whatsapp_inboxRead conversations, reply with text, buttons or a file, and check one sent message's delivery (messageId)
list_whatsapp_templates, create_whatsapp_template, delete_whatsapp_templateYour templates and Meta's library: create, edit, delete
manage_whatsapp_numberThe profile, quick questions, commands, blocked people and groups of one number
manage_whatsapp_flowWhatsApp forms: create, edit, publish, deprecate, delete
send_whatsapp_broadcastOne 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.