What this is
Minimo runs the WhatsApp side (the Meta Cloud API, 360dialog or Twilio connection, the number, the inbox, templates, delivery) and your backend decides what to answer. You receive every message on a signed webhook, run your own bot or AI, and send the reply back with one API call. Minimo is the transport, your bot is the brain. It is how an external product (for example a legal AI) puts its own assistant on a WhatsApp number without building a WhatsApp integration.You need a WhatsApp number already connected to your workspace in Minimo (Channels).
Connecting a number is done in the app, not with this API.
The flow
1
A contact writes to your WhatsApp number
Meta (or 360dialog, Twilio) delivers the message to Minimo.
2
Minimo sends the event to your webhook
A
whatsapp.message.received event, the same for every provider, signed and retried. See Webhook
Events.3
Your backend decides the reply
Your bot or AI reads the event and writes the answer. Minimo runs no logic here.
4
You send the reply with the Minimo API
Send a Message: a text inside the 24-hour window, or an approved
template. Minimo delivers it and records it in the inbox.
5
(Optional) Delivery status and history
Subscribe to
whatsapp.message.status to learn when a message is delivered, read or failed, and use List
Conversations to read the history.Authentication
Every call sends a Minimo API key with the WhatsApp permission:Transactional key.
The workspace always comes from the API key: you never pass a company id. A key only reads and writes its own workspace.
Endpoints
All onhttps://api.minimo.it.
One responder per number
Each WhatsApp number has one responder: Minimo’s AI assistant, your bot, or nobody (messages wait in the inbox for your team). Two never answer the same message.- Register an active webhook for
whatsapp.message.received: every WhatsApp number of the workspace switches to your bot, and Minimo’s AI assistant stops replying on them. - Delete it, pause it, or remove the event, so that no such webhook is left: the numbers go back to the inbox. The AI assistant does not come back on its own: turn it on again in Minimo if you want it.
Next steps
Register a webhook
Receive the messages your contacts write.
Send messages
Reply with a text, a template, media or buttons.
Read history
Page through conversations and messages.
Notes & limits
Limits, common errors, security checklist.