Phone Numbers

Overview

Phone numbers are the sending identity for WhatsApp Business Platform. Each number is linked to a WABA and can be used for app, coexistence, and API workflows depending on setup.

• A phone number can only be actively attached to one WhatsApp business setup at a time.
• Number ownership, quality, and policy status affect messaging eligibility.
• In Dualhook, numbers are managed in your own Meta assets — Dualhook does not own your numbers.

Where to Find Phone Numbers in Meta

1. Open Meta Business settings.
2. Go to Accounts → WhatsApp Accounts.
3. Select your WABA.
4. Open WhatsApp Manager and go to Phone numbers.

From this view you can usually see the display phone number, verification and name status, and the phone_number_id used for API sending.

Adding a Phone Number

Common path:

1. In WhatsApp Manager, open Phone numbers.
2. Click Add phone number.
3. Choose country code and enter the number.
4. Complete OTP verification (SMS or voice).
5. Complete display name review steps if prompted.

You can onboard numbers through Embedded Signup and then manage them in Dualhook, or add them in Meta first and then connect through Dualhook.

Portfolio and Number Limits

Portfolio-level number capacity is controlled by Meta account state. In many setups, businesses start with a lower number limit and can increase over time as trust and verification improve.

• Keep business verification and policy compliance in good standing.
• Monitor quality and messaging limits per number.
• Do not assume every portfolio has the same number capacity from day one.

Removing a Phone Number

Before deleting any number:

• Stop active sends and campaigns that use the number.
• Disconnect or update any webhook/send logic that points to that number.
• In Dualhook, disconnect or update the related connection first.

Typical Meta removal flow:

1. Open WhatsApp Manager → Phone numbers.
2. Select the target number.
3. Use the remove/delete action (trash/bin icon).
4. Confirm the removal prompt.

Important:

• Deletion can be restricted by permissions, billing/account state, or recent paid usage.
• Meta may apply cooling periods before some numbers can be removed.
• Only users with sufficient Business admin permissions can complete deletion.

Common Issues

Delete button is missing

• Your role lacks admin rights.
• The number is controlled by another portfolio or partner setup.
• The number is in a state that blocks removal.

Number cannot be added

• Number is already registered elsewhere.
• OTP verification failed or timed out.
• Number format, provider restrictions, or unsupported type.

Messages fail after number changes

• Old phone_number_id is still used in sending code.
• Webhook routing still points to the previous setup.