Onboarding and Sending Messages

This documentation aims to guide partners on how to onboard clients in the Beta version of Meta’s MM Lite API.

Onboard a Business to MM Lite

Before You Start

In MM Lite, we call onboarding the process where the client reviews and accepts the MM Lite API Terms of Service. Onboarding is always performed by the client at a WABA level. There are currently two ways to onboard:

Using Embedded Signup (ES):

The client clicks a new onboarding link, logs into their Facebook account, selects the BM, and accepts the Terms of Service.

Using Intent API

The client receives a notification in their Business Manager under Settings > Requests to accept the terms. Can be used to onboard multiple BMs at once.

Pre-Onboarding Checklist

Before sharing the onboarding link or requesting the Intent API onboarding, make sure the client meets all the following requirements:

• The Business Manager has at least one active Ad Account (If not, see how to create one)

• The user performing onboarding has Admin access to the Business Manager (How to manage access)

• The user has Admin access to all WhatsApp Accounts within that BM (How to grant access)

• The account has a valid Cloud API setup (API key, webhook URL configured)

Important Notes

• MM Lite onboarding happens at the Business Manager level, meaning onboarding must be done by each client.

• Only clients can complete the onboarding process. As a partner, you cannot onboard on their behalf.

• The link will only work for users with Admin access to the client’s BM.

Using Embedded Signup (ES)

Clients can onboard their business to the MM Lite API using the Alpha-Beta-Onboarding service.

1

Go to https://metaonboarding.360dialog.io

2

Log in and click “Add a new number”

3

When prompted, select the following options:

• Alpha callback

• Yes, this number is connected to WhatsApp Business API

• Yes, planning to send marketing messages from this number

4

Start the Embedded Signup (ES) process

5

When asked, select the correct Business Portfolio to continue

6

Accept the Terms of Service

7

Click "Finish"

🎥 Need help? Watch this step-by-step tutorial to guide your client through the process.

How to onboard on MM Lite Beta

Using Intent API

If your client prefers not to use Embedded Signup, they can onboard via Bulk Onboarding.

Here’s how it works:

1

The partner sends an email to [email protected]

2

In the email, include the list of BM IDs for which the onboarding requests should be sent

The request will be sent to the clients' Business Manager

3

Our team will reply back confirming once the requests have been sent

What the client needs to do:

Once the requests are sent, the client (with Admin permissions in the Business Manager) should:

1

Go to Business Manager > Settings > Requests

2

Find the MM Lite onboarding request

3

Click to view and accept the Terms of Service

Once accepted, MM Lite is active for that Business Manager.

Once the ES process is completed:

• All eligible WABAs in the client's account will be allowed to use MM Lite.

• The onboarding takes up to 10 minutes after completing the ES process.

• Any new WABAs added after onboarding will require a new ES process to enable MM Lite.

---

Sending Messages with MM Lite

To send a template message you will need to use a POST request:

POSThttps://waba-v2.360dialog.io/marketing_messages

Headers

Name	Value	Description
Content-Type	application/json
D360-API-KEY	Bearer <token>	D360-API-KEY received after approval to participate in this program

Body

Field	Required	Description
messaging_product	Yes	"whatsapp"
recipient_type	Yes	"individual"
to	Yes	Recipient phone number in international format. Example: "441234567890"
type	Yes	"template"
template.name	Yes	"marketing_text_no_param"
template.language.code	Yes	"en"
template.language.policy	Yes	"deterministic"
message_activity_sharing	Optional	Set to true to enable activity sharing (can be removed if not needed)

cURL

MM Lite (new)

# MM Lite (new)
curl --location 'https://https://waba-v2.360dialog.io/marketing_messages' \
--header 'Content-Type: application/json' \
--header 'D360-API-KEY: <token>' \
--data '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "<<RECIPIENT_PHONE_NUMBER>>",
    "type": "template",
    "template": {
        "name": "marketing_text_no_param",
        "language": {
            "policy": "deterministic",
            "code": "en"
        }
    },
    "message_activity_sharing":true
}'

Cloud API (current)

# Cloud API (current)
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"
  }'

Response

An usual Cloud API response is expected after a successful message sent using MM Lite API.

200

{
    "messaging_product": "whatsapp",
    "contacts": [
        {
            "input": "<phone number>",
            "wa_id": "<<waba id>"
        }
    ],
    "messages": [
        {
            "id": "wamid.HBgLNTk4OTQ3MTQ0NjMVAgARGBJDNjM1NUM2OEEyMDU4REZERTgA"
        }
    ]
}

Sending a Marketing Template Message with TTL using MM Lite API

MM Lite API provides additional features that are not available to Marketing templates on Cloud API.

This means you can include and set the value of the message_send_ttl_seconds in the payload of your Marketing Message Template to test this feature.

What is Time-To-Live (TTL) for Marketing template messages?

If Meta is unable to deliver a message to a WhatsApp user, they will continue attempting to deliver the message for a period of time known as a time-to-live (TTL), or message validity period.

TTL is available for Authentication and Utility template messages on Cloud API, but TTL for Marketing template messages is exclusively available on Marketing Messages Lite API.

See our documentation on How to set a TTLs for Marketing template messages.