Manage WhatsApp Business numbers
Learn how to add, verify, and check the status of your WhatsApp Business numbers in Omnifox.
In Omnifox you can manage one or several WhatsApp Business numbers from a single place. This guide shows you how to add a number, verify its status, and resolve the most common alerts.
Before you start
- Admin access in your Omnifox workspace.
- Admin permissions over the number's Meta Business account.
- A number that is not already active on another API platform (a number can live on only one at a time).
Step 1: Add a WhatsApp number
- Go to Settings → Channels.
- Click Connect New Channel, choose WhatsApp and name the channel.
- Pick the mode (Coexistence or Cloud API).
- Complete Meta's Embedded Signup: log in, choose your WhatsApp Business account and the number.
- Authorize the permissions and finish.
The number will appear as a new channel in the Channels list.
Step 2: Verify the number
Meta requires you to verify ownership of the number:
- During Embedded Signup, choose to receive the code by SMS or call.
- Enter the 6-digit code.
- If the number was already verified in your Meta account, this step completes on its own.
If you'll use the number on Cloud API and want a Display Name, Meta reviews it separately. Approval can take time; meanwhile the number works with a provisional name.
Step 3: Check the number's status
In Settings → Channels each number shows its status:
- Connected: ready to send and receive.
- Pending / Under review: Meta is still processing verification or the name.
- Disconnected / Error: needs reconnection (see below).
Open the channel to see details: number, mode (Coexistence or Cloud API), and Display Name.
Step 4: Confirm it works
- Send a test message from an external phone to the number.
- Confirm the conversation lands in your inbox.
- Reply from Omnifox and verify delivery.
If it doesn't work
- Channel shows disconnected: go back to Connect New Channel and repeat the flow with the same number; Omnifox updates the existing channel instead of duplicating it.
- Meta rejects all sends (code 190): the channel token expired; reconnect the number via Embedded Signup.
- "Number already in use": it's active on another API platform. Release it there before connecting it to Omnifox.
- Verification code never arrives: wait a few minutes, try a call instead of SMS, and confirm the number's international format.
Tips
- Keep your payment method in Meta up to date; a balance or billing issue can halt sends.
- Use a clear, recognizable Display Name: it improves trust and brand verification.
Related articles
Related articles
-
WhatsApp (Meta) error codes: what they mean and what to do
A table of the most common Meta error codes when sending on WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) and how to fix each one.
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
Instagram and Facebook comments: reply and moderate from Omnifox
See and answer comments on your Facebook and Instagram posts and ads, publicly or privately, and set up automatic replies.
-
Sending and receiving videos on each channel: formats and size limits
Which videos you can send and receive on WhatsApp, Instagram, Messenger, Telegram, web chat and email, the real size limits, and what to do with a large video.
-
Move from WhatsApp QR to Coexistence or Cloud API
Once you're done testing with the QR code, move your number to the official connection: no caps, with templates and broadcasts, and no volume-based ban risk.