Business phone numbers | Developer Documentation

Choose and connect a WhatsApp Business phone number with ChatArchitect

Choose a phone number you control before connecting WhatsApp Business API to ChatArchitect. ChatArchitect does not provide phone numbers; you can use your own mobile, landline, or toll-free number if you can complete the verification step.

Before you start

• Have access to the Facebook account and business portfolio that will own the WhatsApp Business account.
• Make sure the number can receive a verification code by SMS or voice call. For a landline or toll-free number, check that an incoming verification call can reach you without an IVR or call forwarding blocking it.
• Decide what customers should see as your business display name. Keep your business details ready for the setup form.
• If the number is already used in WhatsApp Messenger or the WhatsApp Business app, check the applicable migration or coexistence route before changing that account. Do not remove the existing account just to retry setup.

For a broader preparation list, see the ChatArchitect connection checklist.

Connect the number

1. Start the WhatsApp Business API connection in ChatArchitect and select Continue with Facebook.
2. Continue to the business portfolio selection. Select the portfolio that should own the account, then create a WhatsApp Business account if needed.
3. Enter the requested business details and continue.
4. Select Add a new number and enter the number you want to connect.
5. Choose SMS or voice call and enter the verification code you receive.

The illustrated ChatArchitect setup guide shows these screens. After verification, return to your ChatArchitect connection and check that the number is available there before setting up an integration.

Distinguish the verification code, security PIN and API registration

Confirm the connection before setting up your sending tool

1. Return from the Facebook connection flow to ChatArchitect and confirm that the intended business number is available in your connection.
2. Use the App key and Secret for that connection in your supported CRM, help desk or other tool. Follow the ChatArchitect credentials guide and the instructions for the selected integration.
3. Follow the first-message sending guide to check the message type, permitted recipient and result of a small test.

Completing the SMS or voice step establishes control of the number; check the resulting ChatArchitect connection and integration before treating it as ready for a campaign. If the number is missing or the next step fails, record the portfolio, WhatsApp account, number, affected step, time with time zone and exact error. Send those details to ChatArchitect support without passwords, verification codes, PINs or Secret values.

If an error or an imported guide refers to API registration or de-registration, give support the exact reference and your connection details. Follow the supported connection process when resolving it. For a number already used in WhatsApp Business app, check the coexistence guide before changing that account.

If verification does not finish

If a code does not arrive, confirm that the number and country code are correct and that it can receive the selected type of message or call. For a voice call, temporarily remove call routing that prevents you from hearing the code. Try the other verification method if the form offers it.

If Meta says the number is already in use, stop and check how that existing WhatsApp account should be migrated or connected. If your business details are rejected, use the business verification troubleshooting guide. Number verification and business verification are separate steps.

Next step

Once the number is connected, create a message template for messages that need a template. For platform-specific phone number rules, see Meta's business phone number reference.