MM Lite versus Cloud API

Let’s see how sending a marketing message works with the Cloud API — and how easy it is to do the same with MM Lite

📑Main Difference: Just the Endpoint!

“You only need to update your endpoint to start using MM Lite.”

Feature	Cloud API	MM Lite
Base URL	https://waba-v2.360dialog.io	Identical
Endpoint to be used	/messages	/marketing_messages
Authentication	Same API Key	Same API Key
Payload Format	Identical	Identical
Webhook Behavior	Same structure	Same structure1

1. Additional details related to the cost of MM Lite are included as an informative property.

---

🧪Try It Yourself

We recommend running your own tests by switching your endpoint and observing the results.

✅ No need to change payloads

✅ No need to change webhook logic

✅ Keep your existing token

MM Lite is designed to make your life easier. Start small: test one flow, and evaluate performance gains.

---

Sending a marketing message using the Cloud API

cURL

curl --location 'https://waba-v2.360dialog.io/messages' \
--header 'D360-API-KEY: <api_key>' \
--header 'Content-Type: application/json' \
--data '{
  "to": "<end_client_number>",
  "type": "template",
  "template": {
    "name": "<template_name>",
    "language": {
      "code": "<template_language_code>"
    },
    "components": []
  },
  "messaging_product": "whatsapp"
}'

Python

import requests
import json

url = "https://waba-v2.360dialog.io/messages"
headers = {
    "D360-API-KEY": "<api_key>",
    "Content-Type": "application/json"
}

payload = {
    "to": "<end_client_number>",
    "type": "template",
    "template": {
        "name": "<template_name>",
        "language": {
            "code": "<template_language_code>"
        },
        "components": []
    },
    "messaging_product": "whatsapp"
}

response = requests.post(url, headers=headers, data=json.dumps(payload))

print(response.status_code)
print(response.json())

Ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://waba-v2.360dialog.io/messages")

headers = {
  "D360-API-KEY" => "<api_key>",
  "Content-Type" => "application/json"
}

payload = {
  to: "<end_client_number>",
  type: "template",
  template: {
    name: "<template_name>",
    language: {
      code: "<template_language_code>"
    },
    components: []
  },
  messaging_product: "whatsapp"
}

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri.request_uri, headers)
request.body = payload.to_json

response = http.request(request)

puts response.code
puts response.body

Javascript (Node.js with Axios)

const axios = require('axios');

const url = 'https://waba-v2.360dialog.io/messages';
const headers = {
  'D360-API-KEY': '<api_key>',
  'Content-Type': 'application/json'
};

const payload = {
  to: '<end_client_number>',
  type: 'template',
  template: {
    name: '<template_name>',
    language: {
      code: '<template_language_code>'
    },
    components: []
  },
  messaging_product: 'whatsapp'
};

axios.post(url, payload, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error(error.response ? error.response.data : error.message);
  });

☝️As you may know, we typically expect to receive three webhooks: sent, delivered, and read. However, when a user clicks the link inside a marketing template message sent via the Cloud API, no webhooks are triggered at all.

Webhook events received: sent

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
              "phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
            },
            "statuses": [
              {
                "id": "<WHATSAPP_MESSAGE_ID>",
                "status": "sent",
                "timestamp": "TIMESTAMP",
                "recipient_id": "<CUSTOMER_PHONE_NUMBER>",
                "conversation": {
                  "id": "<conversation_id>",
                  "expiration_timestamp": "TIMESTAMP",
                  "origin": {
                    "type": "marketing"
                  }
                },
                "pricing": {
                  "billable": true,
                  "pricing_model": "CBP",
                  "category": "marketing"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Webhook events received: delivered

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
              "phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
            },
            "statuses": [
              {
                "id": "<WHATSAPP_MESSAGE_ID>",
                "status": "delivered",
                "timestamp": "TIMESTAMP",
                "recipient_id": "<CUSTOMER_PHONE_NUMBER>",
                "conversation": {
                  "id": "<conversation_id>",
                  "origin": {
                    "type": "marketing"
                  }
                },
                "pricing": {
                  "billable": true,
                  "pricing_model": "CBP",
                  "category": "marketing"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Webhook events received: read

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
              "phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
            },
            "statuses": [
              {
                "id": "WHATSAPP_MESSAGE_ID",
                "status": "read",
                "timestamp": "TIMESTAMP",
                "recipient_id": "CUSTOMER_PHONE_NUMBER"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

⚡Now let´s see how it works when we send the same marketing template message using the MM Lite API:

Sending a marketing message using the MM Lite API

cURL

curl --location 'https://waba-v2.360dialog.io/marketing_messages' \
--header 'D360-API-KEY: <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "<end_client_number>",
    "type": "template",
    "template": {
        "name": "<template_name>",
        "language": {
            "policy": "deterministic",
            "code": "<template_language_code>"
        }
    },
    "message_activity_sharing":true 
}'

Python

import requests
import json

url = "https://waba-v2.360dialog.io/marketing_messages"
headers = {
    "D360-API-KEY": "<API_KEY>",
    "Content-Type": "application/json"
}

payload = {
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "<end_client_number>",
    "type": "template",
    "template": {
        "name": "<template_name>",
        "language": {
            "policy": "deterministic",
            "code": "<template_language_code>"
        }
    },
    "message_activity_sharing": True
}

response = requests.post(url, headers=headers, data=json.dumps(payload))

print(response.status_code)
print(response.json())

Ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://waba-v2.360dialog.io/marketing_messages")

headers = {
  "D360-API-KEY" => "<API_KEY>",
  "Content-Type" => "application/json"
}

payload = {
  messaging_product: "whatsapp",
  recipient_type: "individual",
  to: "<end_client_number>",
  type: "template",
  template: {
    name: "<template_name>",
    language: {
      policy: "deterministic",
      code: "<template_language_code>"
    }
  },
  message_activity_sharing: true
}

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri.request_uri, headers)
request.body = payload.to_json

response = http.request(request)

puts response.code
puts response.body

Javascript (Node.js with Axios)

const axios = require('axios');

const url = 'https://waba-v2.360dialog.io/marketing_messages';
const headers = {
  'D360-API-KEY': '<API_KEY>',
  'Content-Type': 'application/json'
};

const payload = {
  messaging_product: 'whatsapp',
  recipient_type: 'individual',
  to: '<end_client_number>',
  type: 'template',
  template: {
    name: '<template_name>',
    language: {
      policy: 'deterministic',
      code: '<template_language_code>'
    }
  },
  message_activity_sharing: true
};

axios.post(url, payload, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error(error.response ? error.response.data : error.message);
  });

⚠️If you see, we only need to use a different endpoint; nothing else is required. The same webhooks are returned, but with a big change: we collect the click event.

Webhook events received: sent

ℹ️It includes the value "marketing_lite" to indicate that it was sent using the MM Lite API:

{
"object": "whatsapp_business_account",
"entry": [
{
"id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
"phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
},
"statuses": [
{
"id": "<WHATSAPP_MESSAGE_ID>",
"status": "sent",
"timestamp": "TIMESTAMP",
"recipient_id": "<CUSTOMER_PHONE_NUMBER>",
"conversation": {
"id": "<conversation_id>",
"expiration_timestamp": "TIMESTAMP",
"origin": {
"type": "marketing_lite"
}
},
"pricing": {
"billable": true,
"pricing_model": "CBP",
"category": "marketing_lite"
}}]},
"field": "messages"
}]}]}

Webhook events received: delivered

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
              "phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
            },
            "statuses": [
              {
                "id": "<WHATSAPP_MESSAGE_ID>",
                "status": "delivered",
                "timestamp": "TIMESTAMP",
                "recipient_id": "TIMESTAMP",
                "conversation": {
                  "id": "<conversation_id>",
                  "origin": {
                    "type": "marketing_lite"
                  }
                },
                "pricing": {
                  "billable": true,
                  "pricing_model": "CBP",
                  "category": "marketing_lite"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Webhook events received: read

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
              "phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
            },
            "statuses": [
              {
                "id": "<WHATSAPP_MESSAGE_ID>",
                "status": "read",
                "timestamp": "TIMESTAMP",
                "recipient_id": "<CUSTOMER_PHONE_NUMBER>"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Webhook events received: click event

It will show you a click_id and a tracking_token.

Currently, it is not possible to identify which end-user number clicked on the marketing message link.

{
"object": "whatsapp_business_account",
"entry": [
{
"id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
"phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
},
"user_actions": [
{
"timestamp": "TIMESTAMP",
"action_type": "marketing_messages_link_click",
"marketing_messages_link_click_data": {
"tracking_token": "<TRACKING_TOKEN>",
"click_id": "<CLICK_ID>",
"click_component": "CTA"
}}]},
"field": "messages"
}]}]}