WhatsApp is connected through Meta, so most problems come down to a verification step that hasn't finished, or a status Meta sets on your number. For first-time setup, see How to connect WhatsApp to Commslayer.
Which problem do you have?
-
The number connected but no messages arrive: start with the checks right below.
-
The number won't connect or shows "Ineligible": skip to The number shows "Ineligible".
Messages aren't arriving after connecting
The inbox looks connected, but no customer messages come in. Work through these in order.
1. Check the verification status
Go to Settings → Inboxes → your WhatsApp inbox → WhatsApp Settings and look at Phone number verification:
-
Connected or Verified: nothing to do here, move to step 2.
-
Pending verification, Not verified or Verification expired: click Send SMS code or Send voice code, enter the 6-digit code under Verification code, and click Verify.
2. Give Meta time to approve the display name
Meta has to approve your display name before registration can finish. Once it's verified and approved, Commslayer completes the registration in the background, which can take about 10 minutes.
3. Send a fresh test message
Only messages that arrive after you connect show up in Commslayer. Conversations from before the connection are never imported, so always test by sending a new message to the number.
4. Check for auto-replies in the WhatsApp Business app
If you're using the number alongside the WhatsApp Business app (coexistence), any automations set up there keep running. A greeting message, an away message or quick replies can answer customers automatically, which can make it look like messages aren't coming through to Commslayer. In the WhatsApp Business app, go to Settings → Business tools, review the Greeting message, Away message and any automations, then turn off anything you don't want running.
5. Check the routing if the number has more than one partner
A number can look connected but still not deliver to Commslayer if Meta is routing its messages to a different partner. If the number has more than one assigned partner in Meta (see What to check in your Meta Business account), check its routing and make sure it points to Commslayer.
If messages still don't arrive after these steps, see Still stuck? at the end.
The number shows "Ineligible" (or a partner-sharing error) during setup
"Ineligible" is a status Meta sets inside its own sign-up window, not something Commslayer controls. You may also see "Failed to share WhatsApp Business account with partners" during the Meta step. Both mean the same thing: Meta won't hand the number to Commslayer yet. There are two causes.
Cause 1: the number is connected to another app
This is the most common reason. A WhatsApp number can only be live on one WhatsApp API connection at a time, which is Meta's rule, so if it's already running on another app or provider (for example Klaviyo, or another helpdesk), Meta marks it Ineligible here.
Check the assigned partners in Meta. Open your Meta Business account, go to your WhatsApp Account, and look at the assigned partners for the number:
-
One partner listed: that's the app holding the number. Connecting it to Commslayer would move it here, and that other app would stop sending and receiving WhatsApp on the number. (On Klaviyo, for example, your flows aren't deleted, but their WhatsApp steps stop going out.) To keep the other app running, use a separate number for Commslayer. Otherwise, remove the partner in Meta and try connecting again.
-
More than one partner assigned: also check the number's routing in Meta. The number can appear connected while Meta routes its messages to a different partner, so make sure the routing points to Commslayer.
-
No partners listed: this isn't the cause. Go to Cause 2.
Cause 2: Meta needs more activity on the number first
If no partner is assigned, "Ineligible" usually means Meta wants to see more activity on the number in the WhatsApp Business app before it will confirm eligibility:
-
Keep using the number normally in the WhatsApp Business app for a little while.
-
Make sure the app is updated (version 2.24.17 or later).
-
Try connecting again.
If it still won't connect after this, see Still stuck? at the end.
Is the error coming from Meta or from Commslayer?
This decides where you fix it. Most WhatsApp setup errors are set by Meta, and those can only be fixed in your Meta Business account, not from Commslayer's settings. It's a Meta-side error when:
-
It appears inside the Meta / Facebook pop-up window during sign-up, not in Commslayer's own screens.
-
It uses Meta's wording, for example "Ineligible", "Failed to share WhatsApp Business account with partners", or a message about your display name or WhatsApp Business Account.
-
It mentions your phone number, WhatsApp Business Account (WABA) or partners.
For those, use the Meta Business checklist below. A problem that shows only in Commslayer, such as a verification status that won't move, or an inbox marked Disconnected, is one you handle in Commslayer first (see the sections above).
What to check in your Meta Business account
Open Business Manager (business.facebook.com) and check these:
-
Assigned partners on the number: under your WhatsApp Account, an app or provider assigned here is the usual cause of "Ineligible". See Cause 1 above for what to do.
-
Routing: with more than one partner assigned, make sure the number's messages are routed to Commslayer, not another partner.
-
Connected apps: under Settings → Integrations → Connected apps, Commslayer should be on the list. If it isn't, the connection didn't complete, so run through setup again.
-
Display name: the number's display name must be approved by Meta before registration can finish. If it's pending or rejected, messages won't flow until it's approved.
-
Phone number status: confirm the number isn't restricted, flagged, or already registered elsewhere.
-
Payment method: a payment method must be on the WhatsApp Business Account to send template messages outside the 24-hour window. The Payment method section of the inbox settings in Commslayer shows whether one is connected.
Can I keep using the WhatsApp Business app?
Yes. Commslayer connects WhatsApp Business app numbers through Meta's coexistence flow, so the app keeps working:
-
New customer messages arrive in both the app and Commslayer.
-
Replies you send from the app also appear in the Commslayer conversation.
Keep in mind that automations you've set in the app (greeting, away messages, quick replies) keep running, as covered in step 4 above. And you can't run the same number on two WhatsApp API providers at once (see Cause 1 above).
Still stuck?
Contact support from the chat inside the app and include:
-
Your phone number
-
Your Meta Business account ID
-
A screenshot (or screen recording) of the status or error Meta shows
That's everything we need to check the number's status on Meta's side.