DevelopersLive

Read conversations and send WhatsApp messages from your own systems.

With the whatsapp scope, list conversations and messages, list approved templates and send messages through the workspace’s connected WhatsApp Business number.

See pricing
POST /api/whatsapp/messagesDemo
curl https://api.nexlerai.com/v1/messages \
  -H "Authorization: Bearer nx_live_••••" \
  -d '{
    "to": "+14155550123",
    "template": "order_update",
    "variables": ["Asha", "#1042"]
  }'

201 Created
{ "id": "msg_8f2c", "status": "queued" }

Sample data shown for illustration.

Overview

What WhatsApp API does

The WhatsApp API lets your CRM, helpdesk or fulfilment system work with the same conversations your team sees in the inbox.

List conversations with paging, status, starred and search filters; read the messages in any conversation; and list approved templates by status, category or language.

Sending follows Meta’s rules. Inside the 24-hour customer-service window you can send free-form text; outside it, only template messages are accepted, and a free-form send returns 409 WHATSAPP_OUTSIDE_SERVICE_WINDOW.

Step by step

How it works

  1. 1

    Create a whatsapp-scoped key

    In Settings → Developer API keys.

  2. 2

    List conversations

    GET /api/whatsapp/conversations to sync threads.

  3. 3

    Pick a template if needed

    GET /api/whatsapp/templates for messages outside 24 hours.

  4. 4

    Send

    POST /api/whatsapp/messages with the recipient and content.

In the product

See it in action

app.nexlerai.com / inbox
Asha Verma ● online
AI replying
Hi! Is the blue one in stock? I need it by Friday.
Yes, 12 left in your size. Order today and it ships tomorrow.
Blue Runner
$49 · In stock
Type a reply…
Illustration with sample data

Sample data shown for illustration.

app.nexlerai.com / automations / cart-recovery
Trigger
Cart left for 1 hour
Wait
Then check the order is still unpaid
Send WhatsApp
“You left something behind” + 10% code
Live1,204 entered212 recovered · $6.1k
Illustration with sample data

Sample data shown for illustration.

Reference

Endpoints

GET/api/whatsapp/conversations

List conversations, most recent first. Query: page, limit, status (open | closed), starred, search, sort.

GET/api/whatsapp/conversations/:conversationId/messages

List messages in one conversation. Query: page, limit.

POST/api/whatsapp/messages

Send a message. Outside the 24-hour window only "template" messages are accepted.

GET/api/whatsapp/templates

List approved templates. Query: status, category, language.

Send a messagehttp
POST /api/whatsapp/messages
Authorization: Bearer nxk_live_your_key_here
Content-Type: application/json

{
  "to": "+919812345678",
  "type": "text",
  "text": { "body": "Hi! Your order has shipped." }
}

# 200 → { "success": true, "data": { "conversationId": "…", "message": { "type": "text", "status": "sent" } } }

In practice

Use cases

01

Shipping updates

Trigger an order-shipped message from your fulfilment system.

02

CRM sync

Mirror WhatsApp conversations into your CRM or helpdesk.

Before you start

Good to know

  • Template sends are charged by Meta and paid from the prepaid WhatsApp wallet.
  • Message only opted-in customers.

About the author

Nexlerate Technologies Pvt LtdParent company, NexlerAI

Nexlerate Technologies Pvt Ltd is the parent company and engineering team behind NexlerAI. The company builds on the official WhatsApp Cloud API, Meta’s Instagram and Messenger platforms, and the Shopify app ecosystem, and writes these guides from how the product works today.

Start with the free Starter plan.

Connect your workspace first, then upgrade to Growth or Scale when you need more stores, seats and revenue workflows.