Expected Erros & Programming Languages

Expected Errors

MM Lite API is designed specifically for sending Marketing template messages. If you try to send any other message type—such as freeform, Authentication, Service, or Utility—you’ll receive an error response. These formats aren't supported in MM Lite.

It’s also important to note that MM Lite is a send-only API. It doesn’t support incoming messages from users. If your use case requires two-way communication, you’ll need to use the Cloud API alongside MM Lite on the same phone number to receive incoming messages and replies.

We demonstrated this dual setup in the Sandbox Testing guide, where Cloud API is used to receive incoming messages while MM Lite handles outbound marketing templates.

Using MM Lite API to send normal text messages

The expected error if we try to send a message which is not a Marketing template message is:

{
    "detail": {
        "error": {
            "message": "(#100) Invalid parameter",
            "type": "OAuthException",
            "code": 100,
            "error_data": {
                "messaging_product": "whatsapp",
                "details": "Message must be a template message."
            },
            "fbtrace_id": "AS8UhxdPr7P7WMufJGTGVGU"
        }
    }
}

Using MM Lite API to send Authentication/Utility templates

The expected error if we try to send a template message that is not a Marketing template message is:

{
    "detail": {
        "error": {
            "message": "(#131055) Method not allowed",
            "type": "OAuthException",
            "code": 131055,
            "error_data": {
                "messaging_product": "whatsapp",
                "details": "Only marketing template messages are supported"
            },
            "fbtrace_id": "AacMONwqoqRZJidqSa1LDey"
        }
    }
}

Not allowed to send messages using MM Lite API

The expected error if we try to send a MM Lite if the phone number is not activated for this Alpha initiative:

{
    "detail": {
        "error": {
            "message":"(#200) You must accept the Marketing Messages Lite API terms to use the API."
            "type": "OAuthException",
            "code": 131055,
            "fbtrace_id": "AacMONwqoqRZJidqSa1LDey"
        }
    }
}

Using the wrong D360-API-KEY

If you use an invalid D360-API-KEY, the request will fail with an authentication error. This typically means the token is incorrect or missing.

{ "error": "Invalid api token." }

Examples using multiple programming languages

1. Postman Collection

Once you’re approved to join the program, you’ll receive a complete Postman collection that includes both successful request examples and the expected error responses.

This collection is designed to help you quickly test and validate MM Lite API behavior across a range of use cases.

HOW TO USE:

1. Import in POSTMAN, the JSON file corresponding to a collection of requests with examples related with MM Lite API.

2. Modify the collection variables, with the values you received from 360Dialog Team.

1. Follow our step-by-step process to validate all successful requests and check this page for possible errors to be received.

2. NodeJS (using request library)

Set current Webhook URL

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://waba-v2.360dialog.io/waba_webhook',
  'headers': {
    'Content-Type': 'application/json',
    'D360-API-KEY': '<token>'
  },
  body: JSON.stringify({
    "url": "https://webhook.site/d4d4df6d-ee02-4572-a021-bcc60836d1e7"
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

See details in our documentation.

Send text message using Cloud API

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://waba-v2.360dialog.io/messages',
  'headers': {
    'Content-Type': 'application/json',
    'D360-API-KEY': '<token>'
  },
  body: JSON.stringify({
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "<phone_number>",
    "type": "text",
    "text": {
      "body": "This is a simple text msg send using cloud api"
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

See details in our documentation.

Send Marketing Template message using Cloud API

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://waba-v2.360dialog.io/messages',
  'headers': {
    'Content-Type': 'application/json',
    'D360-API-KEY': '<token>'
  },
  body: JSON.stringify({
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "<phone_number>",
    "type": "template",
    "template": {
      "name": "marketing_text_no_param",
      "language": {
        "policy": "deterministic",
        "code": "en"
      }
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

See details in our documentation.

Send Marketing Template message using MM Lite

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://alpha-beta-onboarding.hub-production.360dialog.io/mmlite/marketing_messages',
  'headers': {
    'Content-Type': 'application/json',
    'D360-API-KEY': '<token>'
  },
  body: JSON.stringify({
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "<phone_number>",
    "type": "template",
    "template": {
      "name": "marketing_text_no_param",
      "language": {
        "policy": "deterministic",
        "code": "en"
      }
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

See details in our documentation.

3. Python (using request library)

Set current Webhook URL

import requests
import json

url = "https://waba-v2.360dialog.io/waba_webhook"

payload = json.dumps({
  "url": "https://webhook.site/d4d4df6d-ee02-4572-a021-bcc60836d1e7"
})
headers = {
  'Content-Type': 'application/json',
  'D360-API-KEY': '<token>'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

See details in our documentation.

Send text message using Cloud API

import requests
import json

url = "https://waba-v2.360dialog.io/messages"

payload = json.dumps({
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<phone_number>",
  "type": "text",
  "text": {
    "body": "This is a simple text msg send using cloud api"
  }
})
headers = {
  'Content-Type': 'application/json',
  'D360-API-KEY': '<token>'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

See details in our documentation.

Send Marketing Template message using Cloud API

import requests
import json

url = "https://waba-v2.360dialog.io/messages"

payload = json.dumps({
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<phone_number>",
  "type": "template",
  "template": {
    "name": "marketing_text_no_param",
    "language": {
      "policy": "deterministic",
      "code": "en"
    }
  }
})
headers = {
  'Content-Type': 'application/json',
  'D360-API-KEY': '<token>'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

See details in our documentation.

Send Marketing Template message using MM Lite

import requests
import json

url = "https://waba-v2.360dialog.io/messages"

payload = json.dumps({
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<phone_number>",
  "type": "template",
  "template": {
    "name": "marketing_text_no_param",
    "language": {
      "policy": "deterministic",
      "code": "en"
    }
  }
})
headers = {
  'Content-Type': 'application/json',
  'D360-API-KEY': '<token>'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

See details in our documentation.