Skip to main content

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:
Create the key in Developer › API keys (see Authentication). The WhatsApp permission covers exactly this group: sending, webhooks, history and media. Give your bot a key with only this permission. Send a Message and Download Media also accept an older 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 on https://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.