Numbers
Connect WhatsApp numbers to a project and keep them running.
A Number is one WhatsApp account connected to a Polymorfa project. Every message, call and campaign is sent from a Number, so connecting one is the first step of any integration.
Get started#
Create a QuickLink and open its URL on the phone that owns the WhatsApp account. The hosted page confirms the phone number, pairs the account and adds the Number to your project. Polymorfa then returns the Number ID you use in Messaging API paths.
A Number connects in one of two ways:
- Linked Devices: Polymorfa joins the WhatsApp or WhatsApp Business app as a linked device, the same way WhatsApp Web does.
- Meta Cloud API: the Number runs on Meta's Cloud API through Embedded Signup. Meta bills the business's WhatsApp Business Account directly for messaging. Meta Cloud API onboarding requires access.
To build without a real phone, add a test number.
Connect a number with QuickLink
Connect numbers#
- Connect a number with QuickLink: Send a hosted link that pairs a phone or completes Meta signup.
- Connect a number in the Console: Pair a phone that is with you, send a link or add a test number from Numbers.
- Set up Meta Cloud API connections: Prepare a WhatsApp Business Account, use your own Meta app and renew credentials.
- Build your own pairing interface: Request QR codes and pairing codes from your backend. Requires access.
- Import existing sessions: Move a Baileys or whatsmeow session to Polymorfa without pairing again.
Manage numbers#
- Start, stop and restart Numbers: Control a Number's connection, read its status and change its configuration.
- Number tiers and funding: Choose what a Number can do and how its 24-hour paid window is charged.
Limits and capabilities#
- Number capabilities: Read which WhatsApp features WhatsApp has enabled for each Number.
- WhatsApp new-chat cap: See the new-chat limit WhatsApp set for a Number and how sends are paced around it.
Business profile and catalog #
Business tools change what customers see about the business behind a Number. Each method's reference page shows which connection types it supports.
- Business profile: Read and update the description, hours, websites, cover photo and compliance details.
- Catalogs and commerce: Manage products, collections, carts and orders, and send products in messages.
- Quick replies: Manage WhatsApp Business app shortcuts and choose whether Polymorfa remembers them.
Message templates for Meta Cloud API Numbers are covered under Messaging.
Monitor numbers#
- WhatsApp analytics: Read message engagement, call outcomes and connection health for each Number.
- Connect an analytics collector: Export the same measurements to Prometheus or OpenTelemetry.
Build your own pairing interface #
Direct QR and pairing-code requests require direct-pairing access for the team that owns the Number. Without access, they return 403; use QuickLink instead. See Build your own pairing interface.