LogoLogo
Get a demoLog inAcademyDevelopersMore docs
  • Bird CRM docs
    • Explore all products
    • Use cases
      • Bird for travel
        • Abandoned search recovery
        • Flight confirmation
        • Holiday search campaigns
        • Price change alerts
    • About Bird CRM
  • Inbox
    • Inbox
      • Concepts
        • Reports
      • Admin guide
        • Agents
          • Invite an agent to Inbox
          • Remove an agent from Inbox
          • FAQs
        • Tags
        • Routing
        • Teams
        • Feeds
        • Sender profiles
        • Reporting
      • Agent guide
        • 📚1. The basics
        • ⏰2. Your availability status
        • ✉️3. Send and receive messages
        • 💬4. Manage conversations
        • 👥5. View conversation participants
        • 👤6. View a contact's profile
  • Campaigns
    • Campaigns
      • Quickstarts
        • Send a campaign
      • Concepts
        • A/B tests
          • FAQs
        • Branded links
        • Calendar view
        • Campaign tags
        • Frequency limits
        • Scheduling
      • How-to
        • Schedule a campaign
        • Run an A/B test
        • Replicate a campaign
    • WhatsApp campaigns
      • How-to
        • Send a WhatsApp campaign
    • Email campaigns
      • How-to
        • Send an email campaign
    • SMS campaigns
      • Concepts
        • Best practices for MMS campaigns
      • How-to
        • Send an SMS campaign
    • Push notifications
      • How-to
        • Send a push notification campaign
    • New Campaign Builder
  • Automation
    • Journeys
      • Quickstarts
        • Create an abandoned cart recovery journey
      • Concepts
        • Journey templates
        • Journey runs
        • Journey insights
        • Journey reports
      • How-to
        • Use a send message step in a journey
        • Use a wait step in a journey
        • Use a conditional step in a journey
        • Use an update contact step in a journey
        • Use an end journey step in a journey
    • Flows
      • Quickstarts
        • Use template flows
        • Build an inbound flow
      • Concepts
        • Capabilities and limitations
        • Triggers
          • Agent triggers
          • Connector triggers
            • HubSpot triggers
          • Contact triggers
          • Conversation triggers
          • Feed item triggers
          • Message lifecycle triggers
          • Voice triggers
          • Webhook triggers
          • HTTP endpoint trigger
          • WhatsApp flow endpoint trigger
        • Actions
          • Bird API actions
            • Bots actions | API
            • Channel actions | API
            • Collaboration actions | API
            • Conversation actions | API
            • Engagements actions | API
            • Number management actions | API
          • Core actions
            • How to set up global variables in Flows
          • Contact actions
          • Channel actions
          • Conversation actions
          • Connector actions
            • HubSpot actions
            • Open AI actions
          • Voice actions
      • How-to
        • Route conversations based on language
        • Route conversations based on sentiment
        • Set up a business hours auto-responder
        • Create a simple auto-responder
        • Set up conversational marketing
        • Create an FAQ bot
    • Approval Flow
  • Audience & Contacts
    • Sign-up forms
      • Quickstarts
        • Create a sign-up form
        • Create quizzes
      • Concepts
        • Sign-up process
        • Display
        • Colors
        • Targeting
        • Languages
        • Sign-up form analytics
    • Lists and segments
      • Quickstarts
        • Create a segment
      • Concepts
        • Segments
        • Lists
      • How-to
        • Create a segment based on contact activity
        • View contacts in a segment
        • Edit the setup of a segment
        • Delete a segment
        • Create a list
    • Contacts
      • Concepts
        • Contacts
        • Contacts directory
        • Contact profiles
        • Consent and subscriptions
          • Suppressions
          • Managing unsubscribes
          • Opt-ins, consent, and subscription statuses
            • Contacts with a 'blank' subscription status
      • How-to
        • Add contacts
        • Update the subscription status of your existing contacts
        • Send marketing campaigns to contacts with a 'blank' subscription status
        • Export contacts
  • Content
    • Email templates
      • Concepts
        • Email content, styling, and personalization
        • Email design best practices
        • Advanced Email Templating
      • How-to
        • Create an email template
        • Import a custom HTML email
        • Use a prebuilt email template
        • Create personalized abandoned cart, browse and order placed emails
    • Message templates
      • Quickstarts
        • Create a message template
      • Concepts
        • Localization
        • Versioning
        • WhatsApp message templates
          • WhatsApp approved message templates
          • Reply to open conversation message template
          • Commerce messages
        • Apple Messages for Business
        • Push notifications
      • How-to
        • Localize a message template
        • Add variables to a message template
        • Create an SMS message template
        • Apple Messages for Business
          • Use dynamic variables in Apple Messages templates
          • Create a text Apple Messages template
          • Create an image Apple Messages template
          • Create a location Apple Messages template
          • Create a file Apple Messages template
          • Create a rich link Apple Messages template
          • Create a list picker Apple Messages template
          • Create authentication Apple Messages message types
          • Create a quick reply Apple Messages template
          • Create a time picker Apple Messages template
          • Create an iMessage App message template
          • Create a payment Apple Messages template
        • WhatsApp message templates
          • Create a WhatsApp approved message template
          • Create a reply to open conversation WhatsApp message template
          • Create a single product WhatsApp message template
          • Create a catalog WhatsApp message template
          • Create a coupon WhatsApp message template
          • Create an action WhatsApp message template
          • Create a limited time offer WhatsApp message template
          • Create a carousel WhatsApp message template
          • Create Approved WhatsApp Flows Template
          • Create reply to open conversation WhatsApp Flows Template
        • Create Push Notifications message templates
    • Chat widgets
      • Concepts
        • Send and receive messages
      • How-to
        • Build and install a chat widget on a Shopify store
        • Build and install a chat widget on your website
    • Media Library
      • How to Upload Images to the Media Library
    • Translation files
      • Creating and using translation files
    • External Data Sources
    • Lookup Tables
    • Discounts
    • Lookup tables
      • Managing lookup tables
      • Using lookup tables in Flows
    • Products
      • Custom Product Catalog Source
  • Analytics
    • Analytics
      • Concepts
        • Reporting metrics
        • Understanding the Attribution Model
        • List-unsubscribe in email headers
        • Understand Open Tracking
    • Channel analytics
      • Concepts
        • Channel logs
      • How-to
        • Analyze the performance of your channels
    • Campaign reports
      • Concepts
        • WhatsApp campaign reports
        • Email campaign reports
        • SMS campaign reports
      • How-to
        • View campaign reports
        • View A/B test campaign reports
        • See an overview campaign performance
  • Channels
    • Channels
      • Concepts
        • Quiet hours
      • Quickstarts
        • Find and install a channel
        • View information about an installed channel
        • View Channel Logs
      • Supported channels
        • Apple Messages for Business
          • Quickstarts
            • Install Apple Messages for Business
            • Use Apple Messages for Business
          • Concepts
            • Typing indicators
            • User device capabilities
          • How-to
            • Complete onboarding
            • Use entry points
            • Route messages
            • Send messages
            • Use Apple Pay
        • Email
          • Install email
          • Forwarding emails from Gmail
          • IP pools
          • Configure BIMI
        • Facebook Messenger
          • Install Facebook Messenger
          • Use Facebook Messenger
          • Facebook Messenger message types
        • Instagram Messaging
          • Install Instagram Messaging
          • Use Instagram Messaging
          • FAQs and Best Practices
          • Instagram message types
        • LINE
          • Install LINE
        • LinkedIn Pages Messaging
          • Install LinkedIn Pages messaging
          • Use LinkedIn Pages Messaging
          • LinkedIn Pages Messaging Types
        • Numbers
          • Quickstarts
            • Find and buy a new number
            • Activate a number
          • Concepts
            • Number types
            • Know-Your-Customer (KYC)
            • Activation, approval, and rejection
            • Number restrictions in China
          • How-to
            • Use a number
            • Cancel a number
            • Troubleshooting
            • FAQs
        • Push notifications
        • Google RCS
          • Create a Google RCS agent and install Google RCS as a channel
          • Testing and launching your agent
          • Create a Google RCS message template
          • RCS message template types
          • Create and send a Google RCS campaign
          • Create an RCS lead nurture journey with a fallback
          • Use RCS with an AI Agent
          • Grow RCS subscribers with a sign-up form
        • SMS
          • Quickstarts
            • Install SMS
            • Toubleshoot SMS Deliveries Faliures
            • (Missing) SMS delivery status
            • Troubleshoot Channel Health
          • Concepts
            • SMS parts and message length
            • SMS message types and compliance
            • Opt-in and opt-out compliance
            • Choose the right sender : Availability and restrictions by country
              • SMS Country Information Guide: Africa (A-L)
              • SMS Country Information Guide: Africa (M-Z)
                • South Africa
                • Nigeria
              • SMS Country Information Guide: Asia (A-K)
                • Japan
                • India
                • China
              • SMS Country Information Guide: Asia (L-Z)
                • Malaysia
                • Singapore
              • SMS Country Information Guide: Caribbean
              • SMS Country Information Guide: Central America
              • SMS Country Information Guide: Europe (A-M)
              • SMS Country Information Guide: Europe (N-Z)
              • SMS Country Information Guide: Middle East
                • United Arab Emirates
              • SMS Country Information Guide: North America
                • Messaging Best Practices - NORAM SMS / MMS
                • Canada
                • United States
                • Prohibited Content - NORAM SMS / MMS
              • SMS Country Information Guide: Oceania
                • New Zealand
                • Australia
              • SMS Country Information Guide: South America
            • MMS sizes and limitations
            • Automatic sender selection
            • SMS Registration
              • Use case requirements for SMS Registration
              • Setting up a SMS consent flow
              • SMS Privacy Policies
              • SMS Toll-free number
                • TFN Verification
                • Additional Costs for using TFN
                • How-to Guides
                  • Purchase a Toll Free Number via Bird
                  • Register a US or Canadian TFN for SMS via Bird
              • SMS 10DLC
                • How-to Guides
                  • Purchase a 10DLC number via Bird
                  • Register a 10DLC brand via Bird
                  • Register a 10DLC campaign via Bird
                  • Install SMS 10DLC
                  • Delete inactive 10DLC campaigns to avoid additional charges
                • Throughput and Daily Caps
                • Brand registration
                • Campaign registration
                • Additional costs for using 10DLC
                • 10DLC FAQs
            • Page 1
        • WhatsApp
          • Quickstarts
            • Before you start
            • Install WhatsApp
          • Concepts
            • WhatsApp for Business
            • Accounts and verification levels
              • Verified Facebook Business Manager Account
              • Official WhatsApp Business Account (Green tick)
            • Use WhatsApp
            • WhatsApp message types
            • WhatsApp's Customer Care Window
            • FAQs
          • How-to
            • Verify your Facebook Business Manager Account
            • Set up commerce messaging
              • Product inquiries
              • Product orders
            • Create a WhatsApp Flow
              • Create a flow
              • Testing your flow
              • Publishing and sending your flow
              • Handling Flow submission
            • Enable conversational components
            • Become a WhatsApp Tech Provider
              • Onboard as a Tech Provider
              • Connecting to Bird as solutions provider
              • Meta Tech Partner Migration 2024
        • Telegram
          • Install Telegram
          • Bot commands setup
  • AI
    • AI
      • Quickstarts
        • Create an FAQ model
        • Build a detect intent model
      • Concepts
        • AI Assistants
          • Agent Assistant
          • Flows Assistant
          • Studio Assistant
          • FAQ Assistant
          • Audience Assistant
        • AI flow actions
        • AI integrations
        • Detect language: Supported languages
      • How-to
        • Set up and deploy automated FAQs
        • Set up and deploy detect intent models
    • AI Agents
      • Concepts
        • Knowledge bases
        • OpenAI token usage
      • How-to
        • Build a knowledge base
        • Set up an AI Agent
        • Deploy an AI Agent
  • Payments
    • Bird Pay (Beta)
      • Quick Start
        • How to get Bird Pay access?
      • Concepts
        • Onboarding
        • Payment Link
        • Wallet
          • Transfer
          • Recipient
        • Payments
          • Disputes
        • My customers
        • Payouts
        • Payment methods
        • Bird Pay Coverage
        • Strong Customer Authentication (SCA)
      • How-to
        • Create a Payment link
        • Refund a Payment
        • Manage Payout
        • Respond to a Dispute
        • How to set up MFA using the Authenticator app?
      • FAQs
        • Why was my onboarding unsuccessful?
        • How do I update my business address?
        • What are foreign currency fees on my Bird Payments?
        • How to raise an issue with Bird Pay with support?
  • Integrations
    • Integrations
      • Quickstarts
        • Find and install an integration
      • Concepts
        • Integration data sync
      • Supported integrations
        • ActiveCampaign
        • OPERA Cloud
        • Calendly
        • Easyship
        • Google Cloud Translation AI
        • HubSpot
        • Magento 1
        • Magento 2
        • Monday.com
        • Notion
        • OpenAI
        • Rebrandly
        • Salesforce
        • Shopify
        • SugarCRM
        • Zoho CRM
        • TikTok Ads
        • Typeform
        • WooCommerce
        • Zendesk Support
        • Google BigQuery
        • Snowflake
        • Amazon S3
        • Salesforce Marketing Cloud
        • Meta ads
        • Google Ads
  • Account & Billing
    • Account
      • Organization settings
        • General
        • Single-Sign On (SSO)
          • Set up Single-Sign On (SSO)
          • Enforce Single-Sign On (SSO)
          • Entra ID
          • Google Workspaces
          • Okta
        • SCIM
          • Okta setup
          • Entra ID
        • Security Settings
        • Business profile
        • Workspaces
        • Plans & Billing
        • Wallets
        • Users
        • Access policies
        • Access roles
        • Access keys
        • How to find your Organization ID
        • How to find a Workspace ID
        • How to limit a user's access to a single workspace
        • How to download usage report?
        • How to pay (settle) invoices via wallet?
  • Help & Reference
    • Bird support
      • Invite Bird support
    • Deliverability & compliance
      • Email compliance - Bulk sending
      • United States SMS/MMS compliance
        • Key US Regulations
        • General US content restrictions
        • US SMS/MMS compliance
        • US Voice compliance
        • US state-level laws and regulations
        • US compliance & best practices checklist
        • US compliance FAQs
      • Singapore SMS Compliance
    • Data protection
      • Approved subprocessors
    • Release notes
    • Glossary
Powered by GitBook
On this page
  • What you'll need:
  • Installation steps:
  • Step one: Begin installation
  • Step two: Select a phone number for this channel
  • Step three: Connect to Meta and WhatsApp Business Accounts
  • Step four: Setup your WhatsApp Business Profile
  • Step five: Select or verify your WhatsApp Business number
  • What should I do next?
  • Installation criteria and rules

Was this helpful?

  1. Channels
  2. Channels
  3. Supported channels
  4. WhatsApp
  5. Quickstarts

Install WhatsApp

Last updated 11 months ago

Was this helpful?

Install WhatsApp from 'Manage Channels' to gain immediate access to basic messaging features.

To unlock full WhatsApp messaging features, apply for .

What you'll need:

WhatsApp has specific criteria that you'll need to meet when installing the channel. Make sure you're familiar with before you start.

  • An existing personal Facebook account to create or link a Meta Business Manager account. If you are linking an existing Meta Business Account, your personal account must be an admin on the Meta Business Account.

  • The legal name of your company.

  • Your , which will be visible to your customers.

  • The URL of your business' website

  • Your business email address. If you don't have one yet, you can create one during the installation process.

  • The company that you want to send WhatsApp messages with.

  • If you are using your own number access to that phone number for verification during the sign-up process.

Installation steps:

Step one: Begin installation

Find out about , including and .

  1. Click on your name in the bottom left-hand side of your screen, then click Manage Channels.

  2. In Manage Channels, click WhatsApp.

  3. Click Add new channel

Step two: Select a phone number for this channel

Under Step one, choose the option that best applies to your use case:

  • To use a number you have already purchased from Bird, select Select a number from the drop-down.

  • To purchase a new Bird number, select Buy a number from the drop-down.

  • To use your own number, or that of another provider, select I have my own number from the drop-down.

MessageBird numbers that appear in the dropdown list are pre-verified for use with WhatsApp and you will not need to get an OTP code during installation. These will appear as BSP-provided numbers.

Step three: Connect to Meta and WhatsApp Business Accounts

  1. Under "Step 2", click Click here to start.

  2. Log in to your Facebook account and follow the instructions.

    • If you already have a Meta Business Account, select it and then choose the associated WhatsApp Business account.

    • If not, click on "Create a Business Account" and fill in your business details.

  3. Click Get started.

Step four: Setup your WhatsApp Business Profile

If you already have a WhatsApp Business Profile:

  1. Select the WhatsApp Business Profile.

  2. Click Continue.

If you don't have a WhatsApp Business Profile:

  1. Select Create new WhatsApp Business Account.

  2. Choose your Time zone from the drop-down.

  3. Click Continue.

Add a display name, category, and description.

  1. In the WhatsApp Business Display Name field, type your business's name, then click Continue.

  2. From the Category drop-down, select your business category.

  3. In the Business description field, type a description for your business, then click Continue.

All of the information that you enter in this section will be visible to your customers when they contact you on WhatsApp.

Step five: Select or verify your WhatsApp Business number

BSP provided number

If you are using a number that you purchased from Bird this should appear under "BSP-provided numbers'. These numbers have already been verified for use on WhatsApp and do not require additional verification. Select the number you want to install from the list and click Next to complete the installation.

Existing number

If you already have a number associated with your WhatsApp Business Profile, select it here. otherwise, you'll need to register a new number on WhatsApp.

Once your number is set up for WhatsApp Business API, it cannot be disconnected. If you switch from the WhatsApp Business App to the API using the same number, you cannot switch back to the app with the same number. You will need to connect a new clean number.

Verify your own business number

If you are using a number registered with another provider you will need to register and verify this for use on WhatsApp. Ensure that this number is set up to receive OTP codes either via SMS or Voice.

Register a new number

  1. Select Register a new number on WhatsApp.

  2. From the county code drop-down, select the number's country code.

  3. In the number field, type the number that you want to connect to WhatsApp.

  4. Click Continue.

Verify the phone number

Now that you've registered your phone number, WhatsApp will verify it by sending either a text message or placing a voice call. In the call or the message, you will receive a six-digit verification code.

  1. Enter the six-digit verification code.

  2. Select if you received the message via text message or via voice call.

  3. Click Verify.

Now that your number has been verified, you can start to use WhatsApp to send and receive messages and communicate with your customers!

What should I do next?

Installation criteria and rules

WhatsApp number requirements

When installing WhatsApp, you will need to use a valid phone number, which you must have access to during the installation process.

The following rules apply:

  • Number ownership: You must own the phone number that you want to use for WhatsApp Business API. This means that you must have legal control over the number, either by owning it or by having the authorization to use it for business purposes.

  • Number format: The phone number that you register must follow the international format, which includes a country code and an area code. For example, if the phone number is from the United States and has the area code "408" and the number "555-1212", the full number would be "+1-408-555-1212".

  • Number availability: If you are using a number from another provider or the number does not appear in the BSP provided numbers list, you must able to receive calls or SMS messages. WhatsApp will send a verification code to the number as part of the activation process.

  • Number cleanliness: The phone number must be "clean", which means that it hasn't been previously registered with WhatsApp by another user. If the phone number has been used before, it might be associated with a different account, and WhatsApp won't be able to activate it for your business.

Accepted number types

You can use the following number types with WhatsApp:

  • Landline numbers: These are fixed-line numbers that are typically associated with businesses.

  • Mobile numbers: These are traditional mobile phone numbers that can receive SMS messages.

  • Virtual Mobile Numbers (VMN): These are mobile numbers that aren't associated with a physical SIM card, but are voice-capable. VMNs can be purchased from MessageBird and used for WhatsApp Business API activation. The activation token will be sent via a voice call to the VMN.

Prohibited number types
  • Shortcodes

  • Numbers with an IVR (automated call menu) attached to it, unless this feature can be disabled to receive the activation token.

  • Toll-free numbers

Prohibited business verticals

The following business verticals are not allowed by WhatsApp and will not be approved:

  • Adult content

  • Alcohol

  • Animal sales, including live animals, livestock, or any parts of animals

  • Currency

  • Dating

  • Defense

  • Digital subscription and digital content

  • Drugs or related products

  • Gambling

  • Tobacco

  • Weapons, ammunition, explosiv

WhatsApp Business account permissions

To install WhatsApp, you need to grant MessageBird permission to access and manage your WhatsApp account.

You will share:

  • Account access to allow MessageBird to create templates, add phone numbers, send messages, access metrics and assign users to your WhatsApp account.

  • Billing management permissions. By default, a business is billed through MessageBird monthly invoice and we will pass on any charges that your WhatsApp business account incurs.

WhatsApp Business Display name

If the display name represents a business that your company is working with (i.e., if the business is an agency, distributor, partner, or parent company), then the relationship between the business represented in the display name and end-client business must be evident and clear in both parties’ business websites.

For example, if Global Voyager signs up for WhatsApp and wants to use the display name Commercial Air, you must submit links to both websites stating that Commercial Air is a subsidiary of Global Voyager.

If you check the box to say that your display name is different from their legal business name, you will then be prompted to enter a link to a website citing the business relationship.

At the end of the "Connect your account to MessageBird" section, click Continue to share with Bird. This allows us to connect your WhatsApp account to Bird.

Until your business is verified, you'll only be able to use WhatsApp on a limited basis. to get full access to WhatsApp's capabilities.

Apply for

Create a

Respond to inbound WhatsApp messages in

You must add a display name that you will use to message customers. The display name must meet .

Apply for business verification now
Business Verification
WhatsApp Message Template
Inbox
Facebook’s Display Name Guidelines
permissions
Business Verification
the rules
WhatsApp Business display name
phone number
WhatsApp's number requirements
accepted number types
prohibited number types