Install and verify

Before you start

node: >=20.

Use a project with a package.json. Check the runtime and package manager:

1node --version
2npm --version

Install the documented version

1npm install @qentrah/whatsapp@0.1.3

Confirm the installation

1npm ls @qentrah/whatsapp

The output should show @qentrah/whatsapp@0.1.3. Commit the lockfile so another developer installs the same dependency tree.

Quickstart

1import { WhatsAppClient } from "@qentrah/whatsapp";
2 
3const whatsapp = new WhatsAppClient({
4  accessToken: process.env.WHATSAPP_ACCESS_TOKEN!,
5  phoneNumberId: process.env.WHATSAPP_PHONE_NUMBER_ID!,
6  wabaId: process.env.WHATSAPP_WABA_ID,
7  appId: process.env.META_APP_ID,
8  appSecret: process.env.META_APP_SECRET,
9  verifyToken: process.env.WHATSAPP_VERIFY_TOKEN,
10});
11 
12await whatsapp.messages.sendText("201234567890", "Hello from WhatsApp Cloud API");

Expected result

The send promise returns Meta’s accepted message response. Delivery is a separate event reported through webhooks. Replace the example recipient with a permitted test recipient in your Meta setup.

Source captured: 2026-10-11