NLSCEVO · WhatsApp API Reference

NLSCEVO API

Full WhatsApp services — built on the Evolution engine and operated sovereignly by NLSC. Send and receive WhatsApp messages, media, groups and status directly, fully eliminating third-party providers like Twilio. REST over HTTPS, JSON in, JSON out.

Introduction

The NLSCEVO API exposes full WhatsApp capabilities through a clean REST interface. Create instances, pair your own number, and send or receive messages, media and group events — with no per-message fees and no foreign reseller in the path.

Authentication

In Settings, select the API Reference option. Copy the generated token and use it in the Authorization header on your requests as Bearer <copied token>.

curl https://evo.nlscug.com/instance/fetchInstances \
  -H "Authorization: Bearer <copied token>"

Every NLSCEVO token is bound to your verified organisation and your lifetime license. Keep it server-side — it grants full control of your WhatsApp instances.

Base URL

All endpoints are served from:

https://evo.nlscug.com

Instance Controller

An instance is a connected WhatsApp number. Create one, scan the pairing code, and it stays authenticated for the life of your license.

POST/instance/createCreate a new WhatsApp instance

GET/instance/connect/{instance}Fetch the pairing QR / code

GET/instance/connectionState/{instance}Check connection status

DELETE/instance/logout/{instance}Log out & disconnect an instance

curl -X POST "https://evo.nlscug.com/instance/create" \
  -H "Authorization: Bearer <copied token>" \
  -H "Content-Type: application/json" \
  -d '{
    "instanceName": "sales-team",
    "qrcode": true
  }'

Send Text Message

POST/message/sendText/{instance}Send a plain text WhatsApp message

curl -X POST "https://evo.nlscug.com/message/sendText/sales-team" \
  -H "Authorization: Bearer <copied token>" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "256700000000",
    "text": "Hello from NLSCEVO 👋"
  }'

Send Media

Send images, video, audio and documents. Provide a public URL or base64 payload.

POST/message/sendMedia/{instance}Send image, video, audio or document

POST/message/sendButtons/{instance}Send interactive button message

curl -X POST "https://evo.nlscug.com/message/sendMedia/sales-team" \
  -H "Authorization: Bearer <copied token>" \
  -d '{
    "number": "256700000000",
    "mediatype": "image",
    "media": "https://yourdomain.ug/receipt.png",
    "caption": "Your receipt"
  }'

Groups

POST/group/create/{instance}Create a WhatsApp group

POST/group/sendInvite/{instance}Send group invite links

GET/group/participants/{instance}List group participants

Webhooks

Receive every inbound message, delivery receipt and connection event as JSON at your endpoint.

curl -X POST "https://evo.nlscug.com/webhook/set/sales-team" \
  -H "Authorization: Bearer <copied token>" \
  -d '{
    "url": "https://app.yourdomain.ug/whatsapp/hook",
    "events": ["messages.upsert", "connection.update"]
  }'

Errors

{
  "status": 401,
  "error": "Unauthorized",
  "message": "Invalid or missing Bearer token"
}

Standard HTTP codes: 400 invalid input, 401 invalid token, 404 instance not found, 409 instance already connected, 429 rate-limited, 5xx server.

Try It console

Test authentication, send a message and verify a webhook — interactively, without leaving the docs.

Bearer token

Request

curl https://evo.nlscug.com/instance/fetchInstances \
  -H "Authorization: Bearer <token>"

This console runs in a safe sandbox — it validates your request shape and shows the response NLSCEVO returns, without sending live WhatsApp traffic.

NLSCEVO vs Twilio

NLSCEVO delivers full WhatsApp services in-house. Here is how it compares to third-party providers like Twilio.

Feature	NLSCEVO	Twilio & others
Pricing model	One-time USh 760,000 lifetime license	Per-message + per-number monthly fees
WhatsApp sending & receiving	Full inbound & outbound, native	Outbound + inbound via approved templates
Number ownership	Your own number, no reseller lock-in	Number leased from provider
Message templates approval	No third-party gatekeeping	Meta + Twilio template review
Media, groups & status	Images, audio, docs, groups, status	Limited group / status support
Support	Full-time lifetime support included	Paid support tiers
Updates	Lifetime free updates	Subject to API version changes
Data sovereignty	Signed & settled in Uganda (UGX)	Foreign billing & data residency

How can a local Ugandan firm rank this high?

How can a local Ugandan company provide a high-tech, top-ranking WhatsApp & email automation service?

The answer

Evolution Foundation

NLSCEVO is built on the open-source Evolution engine, stewarded by the Evolution Foundation. By self-hosting the Evolution stack on sovereign Ugandan infrastructure and pairing it with our own Email Automation API, NLSC delivers world-class capability without renting it from Twilio or any foreign reseller. The Foundation supplies the proven engine; NLSC supplies the hosting, legal identity, NITA-U compliance and lifetime support — so the ranking is earned locally, not imported.

NLSCEVO ships with the Email Automation API

The NLSCEVO WhatsApp API is sold as one sovereign bundle with the Email Automation API. Together they cover every customer touchpoint — WhatsApp, transactional and bulk email — under a single lifetime license and a single financial handle.

NLSCEVO WhatsApp APIUSh 760,000
Email Automation APIUSh 500,000

Add the bundle to cart →

Pricing & License

USh 760,000

One-time payment · lifetime valid license

◆Lifetime valid license — pay once, own NLSCEVO forever
◆Full WhatsApp services — fully eliminates third-party providers like Twilio
◆Full-time support & help, included for the life of your license
◆New updates eligibility — every future NLSCEVO release at no extra cost
◆Unlimited domain-based instances bound to your verified organisation

Buy the NLSCEVO lifetime license