Send a Message

Endpoint

POST https://api.minimo.it/public/v1/templates/whatsapp/send

Permission: WhatsApp or Transactional (either is accepted). This single endpoint sends two kinds of WhatsApp message, selected by the type field:

type: "text" — a free-form session message, only valid inside the 24-hour customer-initiated window. This is what a bot uses to reply to an inbound message.
type: "template" — a Meta-approved template, valid any time (subject to template category rules).

The company is resolved from your API key. The body carries a deprecated companyId field that is ignored — never send it.

Request body

Field	Type	Required	Description
`recipient`	string	yes	Destination phone number in E.164 (e.g. `393391234567`).
`type`	`"text"` \| `"template"`	yes	Which kind of message to send.
`text`	string	when `type: "text"`	The free-form session message body.
`template`	object	when `type: "template"`	The template reference and parameters (see below).
`sender`	string	no	Which connected number to send from, for multi-number companies. Phone number or Meta `phone_number_id`. Omit to use the preferred number.
`contactSource`	string	no	Label applied if this send creates a brand-new contact (default `WhatsApp`). Existing contacts are never modified. Max 64 chars.

`template` object

Field	Type	Required	Description
`name`	string	one of `name` / `id`	Meta template name. The only way to send a template authored on the Meta/360dialog console.
`id`	string	one of `name` / `id`	Stable Minimo template family id (from List Templates). Survives template version changes.
`languageCode`	string	no	Approved language, e.g. `it`, `en_US`. Omit to let Minimo resolve it (costs a lookup).
`components`	array	no	Components filling the template placeholders.

Pass exactly one of template.id or template.name. Sending both, or neither, is a 400.

Send a session text

Use this to reply to an inbound message from your bot. It only succeeds inside the 24-hour window opened by the customer’s last message — which is exactly the case when you are answering a reply.

curl https://api.minimo.it/public/v1/templates/whatsapp/send \
  -H "Authorization: Bearer mn-abc123-xyz789" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "recipient": "393391234567",
    "type": "text",
    "text": "Thanks for your message! A contract draft is on its way."
  }'

const res = await fetch('https://api.minimo.it/public/v1/templates/whatsapp/send', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mn-abc123-xyz789',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    recipient: '393391234567',
    type: 'text',
    text: 'Thanks for your message! A contract draft is on its way.',
  }),
});
const data = await res.json(); // { success: true }

import requests

requests.post(
    "https://api.minimo.it/public/v1/templates/whatsapp/send",
    headers={"Authorization": "Bearer mn-abc123-xyz789"},
    json={
        "recipient": "393391234567",
        "type": "text",
        "text": "Thanks for your message! A contract draft is on its way.",
    },
)

Send a template

Templates are required to start a conversation or to message outside the 24-hour window.

curl https://api.minimo.it/public/v1/templates/whatsapp/send \
  -H "Authorization: Bearer mn-abc123-xyz789" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "recipient": "393391234567",
    "type": "template",
    "template": {
      "name": "order_confirmation",
      "languageCode": "it",
      "components": [
        {
          "type": "BODY",
          "parameters": [
            { "type": "text", "text": "Jane Doe" },
            { "type": "text", "text": "ORD-12345" }
          ]
        }
      ]
    }
  }'

curl https://api.minimo.it/public/v1/templates/whatsapp/send \
  -H "Authorization: Bearer mn-abc123-xyz789" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "recipient": "393391234567",
    "type": "template",
    "template": {
      "id": "K3J9XQ2",
      "components": [
        {
          "type": "BODY",
          "parameters": [
            { "type": "text", "text": "Jane Doe" },
            { "type": "text", "text": "ORD-12345" }
          ]
        }
      ]
    }
  }'

Template authoring, categories (UTILITY / AUTHENTICATION / MARKETING), the 24-hour window, named vs. positional variables and the full component reference are covered in detail on Send WhatsApp Template. This page documents the same endpoint from the “connect your bot” angle.

Response

{
  "success": true
}

A success: true means Minimo accepted the message and dispatched it to the provider. Delivery status (sent / delivered / read) is tracked in the Minimo inbox; it is not returned inline here.

Choosing the sender (multi-number)

If the company has more than one connected number, set sender to the number you want to send from — either the phone number (any formatting) or the Meta phone_number_id:

{
  "recipient": "393391234567",
  "type": "text",
  "sender": "+393517654321",
  "text": "Hi! How can I help?"
}

An unknown or foreign sender returns WHATSAPP_SENDER_NOT_FOUND. Source valid values from List WhatsApp Senders.

Inbound Webhook — receive the messages you reply to
List WhatsApp Senders
List WhatsApp Templates

Overview

Core Data

Messaging Channels

Connect a Bot (WhatsApp)

Legacy (Deprecated)

Endpoint

Request body

`template` object

Send a session text

Send a template

Response

Choosing the sender (multi-number)

​Endpoint

​Request body

​template object

​Send a session text

​Send a template

​Response

​Choosing the sender (multi-number)

​Related

Endpoint

Request body

`template` object

Send a session text

Send a template

Response

Choosing the sender (multi-number)

Related