whatsapp_alt channel.
WhatsApp Alternative is a gated feature. It must be enabled for your team before the
whatsapp_alt channel and the /v1/whatsapp-alt/* endpoints become available. Contact Zavu to enable it. It is not available with test-mode API keys.When to use it
No Business Account
You want to message from a number that isn’t set up on the WhatsApp Business Platform (Cloud API).
Fast onboarding
You need a client’s number live in seconds — scan a QR instead of running embedded signup.
Personal / existing numbers
The number already uses the regular WhatsApp app and you want to automate it without migrating to a WABA.
Two-way conversations
Inbound and outbound texts, media, reactions, and groups, delivered through the same webhooks as every other channel.
How it differs from official WhatsApp
| Official WhatsApp (Cloud API) | WhatsApp Alternative | |
|---|---|---|
| Connection | Meta embedded signup (WABA) | Scan a QR code (like WhatsApp Web) |
| Setup time | Minutes to hours | Seconds |
| Templates | Required outside the 24h window | Not used |
| 24-hour window | Enforced by Meta | Not enforced |
| Egress | Meta’s servers | Zavu residential proxy or your own device |
| Best for | Scale, compliance, marketing | Quick links, existing numbers, conversations |
How it works
Create a session
Call the API to start a session. Zavu spins up a linked-device connection and generates a QR code. See Sessions.
Scan the QR
Open WhatsApp on the phone → Linked devices → Link a device, and scan the QR. The session moves to
ready.Link the session to a sender
Attach the session to one of your senders. That sender’s
whatsapp_alt traffic now routes through the linked number.Send and receive
Send with
channel: "whatsapp_alt" and receive inbound messages via your sender webhook. See Sending & Receiving.Egress: keeping the number active
Every WhatsApp Alternative number reaches WhatsApp through an egress — an in-country residential IP. You choose between the managed Zavu residential proxy and your own Android egress device, and Zavu can automatically fall back between them so the number stays active. See Egress & Fallback.Connecting clients via invitations
If you’re a partner onboarding clients, you can send a QR-link invitation instead of driving the session API yourself — setconnectionType: "whatsapp_alt" when creating a partner invitation. The client scans the QR and the resulting sender lands in your project.
Next steps
Sessions
Create a session, get the QR, link it to a sender.
Egress & Fallback
Zavu proxy vs. your own device, per-GB billing, automatic fallback.
Sending & Receiving
Send on the
whatsapp_alt channel and handle inbound webhooks.Groups
Receive and identify group messages and their author.
Stories & Status
Receive contacts’ status/story updates as opt-in events.
Partner Invitations
Onboard client numbers with a QR-link invitation.
