Skip to main content

Who answers

Each WhatsApp number has one responder: Minimo’s AI assistant, your bot, or nobody (the inbox). An active webhook for whatsapp.message.received makes your bot the responder on every number of the workspace, so the customer never gets two replies. Without one, the numbers go back to the inbox and the AI assistant must be turned on again in Minimo. See One responder per number. Minimo never writes a reply for your bot: you send it with Send a Message.

Current limits

  • Two events. whatsapp.message.received and whatsapp.message.status. Template approval updates are not sent: check them with List WhatsApp Templates.
  • No file in the event. A received media carries providerMediaId: download it with Download Media.
  • Text and media need an open window. They are delivered only within 24 hours of the contact’s last message. Outside it, use an approved template.
  • Page size of the conversation endpoints is at most 100.
  • Webhook retries stop after 5 attempts; the failure is in the delivery logs.
  • At least once. The same event can arrive twice: dedup on X-Minimo-Delivery.

Common errors

Security checklist

  • Give your bot a key with only the WhatsApp permission.
  • Verify X-Minimo-Signature on every delivery, against the raw body: see Verify the signature.
  • Answer 2xx fast and do the work afterwards: a slow endpoint uses up its retries.
  • Never log or show the webhook secret or the API key.