Send WhatsApp messages in TypeScript,
in a few lines.
Unlimited Messaging's TypeScript SDK gives you a fully typed client to send WhatsApp messages from Node.js, Next.js or any serverless runtime. Install the npm package, add your API key, and send - from your regular WhatsApp account, without Meta's official API.
The context
What is Unlimited Messaging's TypeScript WhatsApp SDK?
The TypeScript SDK is a fully typed npm package that wraps our REST API: you install the client, authenticate it with an API key, and send WhatsApp messages from Node.js, Next.js or a serverless function in a few lines.
Without an SDK, integrating WhatsApp in Node.js means writing raw HTTP calls with fetch: building the URL, serializing the JSON, handling authentication headers, parsing the response and guessing the exact shape of the payload. The TypeScript SDK does all of that for you: a Client object, typed methods like client.message.send(), and your editor's autocompletion guiding you through every field.
Because all request and response types are generated from the OpenAPI spec and exported with the package, a typo on a field name or a malformed recipient is caught at compile time - not in production. You keep the robustness of a real REST API, but with the ergonomics of a library designed for TypeScript.
And above all, the SDK relies on your regular WhatsApp account: no Meta Business account to verify, no template to get approved, no per-conversation billing. A POST becomes a method call, and sending WhatsApp from a Node or Next.js backend fits in three lines - OTPs, transactional notifications, bots.
Comparison
Meta's official API in Node vs Unlimited Messaging TypeScript SDK
The same goal - sending a WhatsApp message from TypeScript code - but two very different levels of effort. On the left, Meta's official Cloud API called with raw fetch; on the right, our typed npm SDK. Line by line, here's what each one requires.
| Meta's official API in Node (raw fetch)WhatsApp Cloud API | Unlimited Messaging TypeScript SDKtyped npm package | |
|---|---|---|
| Installation | No package, fetch written by hand | npm install @unlimited-messaging/sdk |
| Typing | None, untyped JSON payloads | Fully typed requests and responses |
| Business account required | Verified Meta Business account | Your regular WhatsApp account |
| Templates | Meta approval required | No approval, free text |
| Lines of code to send | About ten (URL, headers, body, fetch) | Three: import, client, send() |
| Media | Upload then reference by media ID | Image, PDF or video by simple URL |
| Webhooks | Endpoint to verify and host | Status webhooks ready to plug in |
| Unlimited | Per-conversation billing | Fixed price, unlimited messages |
Our approach
A TypeScript SDK built for Node.js and serverless
We keep the power of the REST API - media, webhooks, delivery statuses - and wrap it in a typed npm client that integrates in a few lines into any JavaScript project.
Fully typed, end to end
Every request and response type is generated from the OpenAPI spec and exported with the package. Your editor autocompletes the fields, and payload errors are caught at compile time, not in production.
Installed from npm
One npm install @unlimited-messaging/sdk and the client is ready. Compatible with Node.js, Next.js, and most serverless runtimes.
Media and webhooks included
Send images, PDFs and videos by URL, and receive delivered / read / reply statuses via real-time JSON webhooks.
Your account, unlimited
The SDK sends from your regular WhatsApp account. No Meta official API, no templates, no per-conversation cost.
- Lines to send a WhatsApp
- 3Lines to send a WhatsApp
- Typed requests and responses
- 100 %Typed requests and responses
- Meta business accounts required
- 0Meta business accounts required
- From npm install to first send
- 5 minFrom npm install to first send
How it works
Send a WhatsApp in TypeScript in three steps
- 1
Install the SDK
npm install @unlimited-messaging/sdk in your Node.js or Next.js project. The typed client is ready to use.
- 2
Authenticate
Generate an API key from the dashboard and pass it to the Client constructor. One key per project, revocable at any time.
- 3
Call send()
client.message.send({ recipient, text }) sends the WhatsApp message. Add a media URL if needed, and listen for delivery webhooks.
FAQ
Questions about the TypeScript WhatsApp SDK
Sources
Sources & references
To check the information in this article for yourself:
Written by
Ilian · Senior Software Engineer
A senior software engineer, he founds and runs several tech companies. He builds products around messaging APIs, automation and AI integration, and shares here what he learns while building.
Send your first WhatsApp in TypeScript today.
Create your account, generate your API key and install the SDK: three lines stand between you and your first WhatsApp message.
Get my API key