Skip to content
DoveMesh
Docs menu

Quickstart

Send WhatsApp messages from your own software: get a number, create an API key, find your phone number ID and send your first template message.

You can send your first message in four steps.

1. Get a number. Sign in at app.dovemesh.com and open Messaging → WhatsApp. Under Get a WhatsApp number, choose Open WhatsApp sign-up and finish the sign-up in the new tab with your Facebook business account. Use a number that isn't on the WhatsApp app. Then enter the number with its country code and choose Send and pay to pay for its WhatsApp API plan. We attach paid numbers within one working day and email you. Numbers already connected to your team are listed on the same page.

2. Create an API key. Open Developers and create a key under API keys. Under Numbers, choose one of your team's numbers or all of them. Keys start with dm_live_, and you see each one only once, so store it safely.

3. Check the key and find your IDs. This call shows the WhatsApp numbers your key works for:

bash

curl https://wa.dovemesh.com/v3/getuserdetails \
  -H "apikey: dm_live_..."

json

{
  "code": 200,
  "status": "SUCCESS",
  "data": [
    {
      "whatsapp_business_account_id": "105954558954427",
      "wanumber": "+919876500000",
      "phone_number_id": "106540352242922"
    }
  ]
}

Keep phone_number_id, which you need to send messages, and whatsapp_business_account_id, which you need to manage templates.

4. Send a template. A business must start a conversation with an approved template (see The 24-hour window). Replace order_shipped with one of your approved templates:

bash

curl https://wa.dovemesh.com/v3/106540352242922/messages \
  -H "apikey: dm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "919876543210",
    "type": "template",
    "template": { "name": "order_shipped", "language": { "code": "en" } }
  }'

The response contains the message ID (wamid.…). Delivery and read receipts for it arrive on your webhook.

Using an AI coding assistant? Give it these docs so it can look up endpoints and examples while it writes your code.