WhatsApp numbers

Use your own WhatsApp number so customers recognize your business. You can connect a Bird number allocated to your workspace, connect an existing number you own, or keep using a number in the WhatsApp Business App.

Choose a connection path

Coexistence numbers have a fixed API throughput of 20 messages per second.

Cost

WhatsApp numbers have no additional charges.

Check connection status

Open Numbers to check a number's status, update its profile, or change its settings. To add a number, follow Connect your number.

For verification_code_not_received or verification_rate_limited, open the number and select Try again. Check retry timing before retrying. For other setup failures, disconnect the failed number and connect it again.

Check number details

Select a number to see its Quality rating, Messaging limit, and Send rate. Meta sets these values. Not rated means Meta does not yet have enough history to rate the number.

Open Business profile to edit the name, description, address, or photo customers see. Activity shows the number's sending activity.

Check the business account

Select an account in the WABA column to open its WhatsApp Business Account details.

• Business verification shows whether Meta has verified your business.
• Marketing Messages API shows whether the account can use Meta's marketing delivery optimizations.
• Last read from WhatsApp shows when Bird last refreshed the account details.

If you have several accounts, check the one linked to your sending number.

Read your numbers from the API

Use an API key with whatsapp_management read access. List numbers to get their IDs, phone numbers, and statuses:

for await (const number of bird.whatsapp.numbers.list({ limit: 25 })) {
  console.log(number.id, number.phone_number, number.status);
}

for number in client.whatsapp.numbers.list(limit=25):
    print(number.id, number.phone_number, number.status)

for number, err := range client.Whatsapp.Numbers.List(ctx, bird.WhatsappNumbersListParams{Limit: 25}) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(number.Id, number.PhoneNumber, number.Status)
}

foreach ($bird->whatsapp->numbers->list() as $number) {
    echo $number->getId(), ' ', $number->getPhoneNumber(), ' ', $number->getStatus(), PHP_EOL;
}

curl -sS "https://us1.platform.bird.com/v1/whatsapp/numbers?limit=25" \
  -H "Authorization: Bearer $BIRD_API_KEY"

Read a number to check its status, quality rating, and sending limits. For other details, use:

During setup, status can be preparing or awaiting_signup. Check next for the action to take. Open finish_setup_url to complete the browser step.

Use the dashboard or CLI to connect, rename, or disconnect a number. These actions are not available through the public API or SDKs.

Enable conversations

Open your number's Settings and turn on Enable conversations. See WhatsApp conversations for details.

Number options

• A number allocated to your workspace: follow Connect your number. Bird receives the verification code for you.
• A number from another provider: choose I have my own number and receive Meta's verification code by SMS or voice call.
• A number already registered with WhatsApp: use a supported migration or eligible Business App Coexistence flow.

Enter a Phone registration PIN if the number already has one on WhatsApp.

Default numbers let you send supported templates without connecting your own number.

Next steps

• Send a WhatsApp message
• Choose a template
• Review the WhatsApp log