wa-clientWhatsApp Cloud API, fully typed

Messages, media, templates, webhooks and Embedded Signup in one zero-dependency package.

🧩

Fully typed

Every request, response and webhook event is typed. Autocomplete for message types, template components and error codes.

🔐

Secure webhooks

Constant-time X-Hub-Signature-256 verification, verify-token handshake, and a parser that flattens payloads into typed events.

🛡️

Production defaults

Timeouts, AbortSignal, exponential backoff on rate limits, and no blind retries of POSTs, so nothing gets sent twice.

🪶

Zero dependencies

Uses the platform fetch and Web Crypto. Runs on Node.js 22+, Bun, Deno and edge runtimes. ESM + CommonJS.

📦

Bulk sending

Send templates to thousands of recipients with bounded concurrency, per-recipient variables and progress callbacks.

🚀

Embedded Signup

Helpers for SaaS platforms. Exchange codes, subscribe webhooks, register numbers with retry.

At a glance

import { WhatsAppClient } from "@osamahalhwawi/wa-client";

const wa = new WhatsAppClient({
  token: process.env.WA_TOKEN!,
  phoneId: process.env.WA_PHONE_ID!,
});

await wa.sendText("966500000000", "Hello 👋");