# 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](https://docs.polymorfa.com/numbers/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](https://docs.polymorfa.com/testing/test-numbers).

[Connect a number with QuickLink](https://docs.polymorfa.com/numbers/quicklink)

## Connect numbers

- [Connect a number with QuickLink](https://docs.polymorfa.com/numbers/quicklink): Send a hosted link
  that pairs a phone or completes Meta signup.
- [Connect a number in the Console](https://docs.polymorfa.com/numbers/connect-in-console): Pair a phone
  that is with you, send a link or add a test number from **Numbers**.
- [Set up Meta Cloud API connections](https://docs.polymorfa.com/numbers/cloud-api-setup): Prepare a
  WhatsApp Business Account, use your own Meta app and renew credentials.
- [Build your own pairing interface](https://docs.polymorfa.com/numbers/direct-pairing): Request QR
  codes and pairing codes from your backend. Requires access.
- [Import existing sessions](https://docs.polymorfa.com/numbers/import-sessions): Move a Baileys or
  whatsmeow session to Polymorfa without pairing again.

## Manage numbers

- [Start, stop and restart Numbers](https://docs.polymorfa.com/numbers/manage): Control a Number's
  connection, read its status and change its configuration.
- [Number tiers and funding](https://docs.polymorfa.com/billing/number-tiers): Choose what a Number can
  do and how its 24-hour paid window is charged.

## Limits and capabilities

- [Number capabilities](https://docs.polymorfa.com/numbers/capabilities): Read which WhatsApp features
  WhatsApp has enabled for each Number.
- [WhatsApp new-chat cap](https://docs.polymorfa.com/numbers/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](https://docs.polymorfa.com/numbers/business-profile): Read and update the
  description, hours, websites, cover photo and compliance details.
- [Catalogs and commerce](https://docs.polymorfa.com/numbers/catalog): Manage products, collections,
  carts and orders, and send products in messages.
- [Quick replies](https://docs.polymorfa.com/numbers/quick-replies): Manage WhatsApp Business app
  shortcuts and choose whether Polymorfa remembers them.

Message templates for Meta Cloud API Numbers are covered under
[Messaging](https://docs.polymorfa.com/messaging#templates).

## Monitor numbers

- [WhatsApp analytics](https://docs.polymorfa.com/numbers/analytics): Read message engagement, call
  outcomes and connection health for each Number.
- [Connect an analytics collector](https://docs.polymorfa.com/numbers/analytics/collectors): 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](https://docs.polymorfa.com/numbers/direct-pairing).

## More resources

- [Numbers API reference](https://docs.polymorfa.com/api/numbers/list-sessions)
- [QuickLinks API reference](https://docs.polymorfa.com/api/quicklinks/create-quick-link)
- [Customer pairing links](https://docs.polymorfa.com/customers/pairing-links)
- [Number events](https://docs.polymorfa.com/development/webhooks)
