Messages

Endpoints for sending and managing messages

Send Message

post

Send a message via the messaging API. Supports text, media, and template messages with automatic routing to marketing messages endpoint when applicable. Supports MM API fallback mechanism, more info: https://docs.360dialog.com/partner/messaging-and-calling/sending-marketing-messages/technical-details-for-mm-api.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Body

application/json

Message Payload

messaging_productstringRequiredExample: whatsapp

recipient_typestring · enumRequiredPossible values:

tostringRequired

typestring · enumRequiredPossible values:

Responses

200

Message sent successfully

application/json

messaging_productstringOptional

400

Bad request

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

post

/messages

HTTPcURLJavaScriptPython

POST /messages HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1206

{
  "audio": {
    "id": "text",
    "link": "text"
  },
  "context": {
    "message_id": "text"
  },
  "document": {
    "id": "text",
    "link": "text"
  },
  "image": {
    "id": "text",
    "link": "text"
  },
  "interactive": {
    "action": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "body": {
      "text": "text"
    },
    "footer": {
      "text": "text"
    },
    "header": {
      "document": {
        "id": "text",
        "link": "text"
      },
      "image": {
        "id": "text",
        "link": "text"
      },
      "text": "text",
      "type": "text",
      "video": {
        "id": "text",
        "link": "text"
      }
    },
    "type": "button"
  },
  "location": {
    "address": "text",
    "latitude": 1,
    "longitude": 1,
    "name": "text"
  },
  "messaging_product": "whatsapp",
  "reaction": {
    "emoji": "text",
    "message_id": "text"
  },
  "recipient_type": "individual",
  "sticker": {
    "id": "text",
    "link": "text"
  },
  "template": {
    "components": [
      {
        "index": 1,
        "parameters": [
          {
            "currency": {
              "amount_1000": 1,
              "code": "text",
              "fallback_value": "text"
            },
            "date_time": {
              "fallback_value": "text"
            },
            "document": {
              "id": "text",
              "link": "text"
            },
            "image": {
              "id": "text",
              "link": "text"
            },
            "location": {
              "address": "text",
              "latitude": 1,
              "longitude": 1,
              "name": "text"
            },
            "text": "text",
            "type": "text",
            "video": {
              "id": "text",
              "link": "text"
            }
          }
        ],
        "sub_type": "quick_reply",
        "type": "header"
      }
    ],
    "language": {
      "code": "en_US"
    },
    "name": "hello_world"
  },
  "text": {
    "body": "text",
    "preview_url": true
  },
  "to": "text",
  "type": "text",
  "video": {
    "id": "text",
    "link": "text"
  }
}

{
  "contacts": [
    {
      "input": "text",
      "wa_id": "text"
    }
  ],
  "messages": [
    {
      "id": "text",
      "message_status": "accepted"
    }
  ],
  "messaging_product": "text"
}