Skip to main content
    Account IssuesEnvoy

    WhatsApp Phone Number Not Eligible for Envoy

    During Envoy's WhatsApp onboarding, you see: "Your phone number is not eligible to connect to the WhatsApp Business Platform."

    2 min readUpdated 9 Apr 2026
    General WhatsApp guide available at /learn/whatsapp

    Meta requires a minimum level of activity on the WhatsApp number before it can connect to the Cloud API. New or inactive numbers get rejected.

    Step 1: Increase Phone Activity

    Before retrying the Envoy onboarding:

    1
  1. Use the phone number actively on WhatsApp for at least 1-2 weeks
    2. 2
  2. Send and receive messages with real contacts
    3. 3
  3. Make sure the WhatsApp app is updated to the latest version
    4. 4
  4. Avoid creating a brand-new WhatsApp account just for business. Meta flags these

    5. Step 2: Retry Onboarding

    1
  5. In Envoy, go to Settings > Channels > Add Channel > WhatsApp
    6. 2
  6. Follow the Embedded Signup flow
    7. 3
  7. Select the phone number that now has activity history
    8. 4
  8. Send a test message to confirm the connection is working

    9. If It Still Doesn't Work

    Some phone numbers are permanently ineligible (certain VoIP numbers, numbers flagged by Meta, numbers in restricted regions). If your number remains ineligible after 2 weeks of activity:

    • Try a different phone number
    • Use a physical SIM number rather than a virtual/VoIP number

    Was this article helpful?

    Related Articles

    Account Issues

    How to Unban Your WhatsApp Account: Envoy Guide

    Your WhatsApp number was banned and you need to get it restored so your Envoy channel works again.

    Account Issues

    WhatsApp Account Banned: What to Do in Envoy

    You see: "This account can no longer use WhatsApp." Your number is banned.

    Account Issues

    WhatsApp Account Blocked: How to Restore Access in Envoy

    Your WhatsApp Business number has been blocked by Meta. Messages won't send, and you may see a warning in your WhatsApp Business app. Here's how to get back online through Envoy.