Docs
Sign up now
  • Getting started
    • Welcome to Sortment
    • Core Concepts
  • Schema
    • Overview
    • Related and Events Table
    • Setting Up Related Table
    • Setting Up Events Table
    • Custom Properties
  • ENGAGE
    • Audiences
      • Creating Audience Using Visual Builder
      • Audience Filters
      • Campaign Event Filters
      • Creating Audience Using SQL Builder
      • Managing Audiences
      • Sync Schedule
      • Audience Insights
    • Campaigns
      • Overview
      • Building a Campaign
      • Campaign Reports
        • Glossary
      • Conversion Tracking
  • Profiles
    • User Profile View
  • Traits
    • Use Cases
    • Calculated Traits
      • Advanced Mode
    • Dynamic Traits
  • Setup
    • Data Warehouses
      • Snowflake
      • BigQuery
      • Redshift
      • Databricks
      • PostgreSQL
    • Cloud Bucket Storage
      • Amazon S3 for Snowflake
      • Google Cloud Storage for BigQuery
      • Amazon S3 for Redshift
      • Amazon S3 for Databricks
    • Communication Channels
      • Email
        • SendGrid
        • SES
        • Mailmodo
      • SMS
        • MSG91
        • Gupshup
      • WhatsApp
        • Meta (Facebook)
          • Add new Phone Number to Meta
        • Gupshup Enterprise
        • WATI
        • Gallabox
        • Yellow.ai
        • Kaleyra.io
    • Real-time Events
      • Setting up Event Source
      • Whitelist Event Payload
  • Sync Schedules
  • Audit Logs
  • Subscription Groups And Contact Fields
  • Delivery Controls
  • Alerts
  • Handlebars
  • Test Profiles
  • Data and Security
    • Technical Overview
    • Warehouse Data Practices
    • Data Access And Usage
    • Security Compliance
    • Audit Logs
    • Privacy Policy
Powered by GitBook
On this page
  • Before You Start
  • Step 1: Add a new phone number
  • Step 2: Create system user and generate access token
  • Step 3: Get Phone Number ID
  • Step 4: Get WhatsApp Business Account ID
  • Step 5: Message Delivery Status

Was this helpful?

  1. Setup
  2. Communication Channels
  3. WhatsApp
  4. Meta (Facebook)

Add new Phone Number to Meta

PreviousMeta (Facebook)NextGupshup Enterprise

Last updated 6 months ago

Was this helpful?

Before You Start

You will need:

  • A Meta developer account

  • A business app — . If you don't see an option to create a business app, select Other > Next > Business during app creation).

Step 1: Add a new phone number

At this point, if you created a new app, you’ll be prompted to Add products to your app. Scroll down, and under WhatsApp, select Set up. Otherwise, select your app from the My Apps screen, and you can follow the same instructions again to add the WhatsApp product to your app.

Navigate to the Meta App that is set-up for WhatsApp by going to developers.facebook.com > My Apps > Select your App.

  1. Use left menu to navigate to the WhatsApp > API Setup panel.

  2. On the right pane select Add phone number button under Step 5: Add a phone number.

  3. Use the to enter a display name for your phone number. This is the name that will show for your business phone number once approved.

  4. Select your Timezone. This will be used for WhatsApp Billing and analytics.

  5. Select a Category for your business and enter a Business description.

  6. Select Next to begin the phone number verification process.

  7. Select your country code from the drop down and enter the phone number you would like to register.

  8. Select how you would like to receive your verification code, either by Text Message or Phone and click Next to continue. You will need access to the phone number before selecting Next to receive the verification code.

  9. Enter the verification code once received and click Next to continue.

  10. The phone number will appear in the From drop down menu of the Send and receive messages section of the panel.

  11. Select the newly added phone number to begin sending messages.

Step 2: Create system user and generate access token

  1. Locate your business account in the top-left dropdown menu and click its Settings (gear) icon.

  2. Click Business settings.

  3. Navigate to Users > System users.

  4. Click the Add button and create either an admin or employee system user.

Generating System User Access Tokens

To generate a System User access token after creating a system user:

  1. Locate your business account in the top-left dropdown menu and click its Settings (gear) icon.

  2. Click Business settings.

  3. Navigate to User > System users.

  4. Select the appropriate system user from the list of system users.

  5. Click the Generate new token button.

  6. Select the app that will use the token.

  7. Provide access to "WhatsApp Business Messaging" and "WhatsApp Business Management" and generate the token.

Step 3: Get Phone Number ID

  1. Find "Getting Started" under "WhatsApp" from the left navigation panel.

  2. In the "Send and Receive Message", find the number you want to use in the "Phone Number" drop-down and select it.

  3. This will display the "Phone Number ID" right below the drop-down menu. This will be your "Phone Number ID" on Sortment.

Step 4: Get WhatsApp Business Account ID

  1. Navigate to Business Settings -> Accounts -> WhatsApp accounts -> Account Name.

  2. On top right corner, you will find the WhatsApp Business Account ID (WABA ID)

Step 5: Message Delivery Status

To update the Callback URL in Meta, follow these steps:

  1. Log in to your Meta account.

  2. On the page that loads, scroll down to find Webhooks under Add products to your app and Click on Set Up.

  3. On the new page, select User from the drop-down and click on Subscribe to this Object.

  4. Subscribe to these topics - 'message_template_quality_update', 'message_template_status_update' and 'messages'. Choose version as v18.0

  5. Enter the Callback URL provided in the Meta Integration popup in the Callback URL field and enter a string in the Verify Token field. This will be relayed to you by Meta for all your verification requests. 'Verify Token' can be any string.

Sign into the .

Sign into the .

Navigate to your page and choose the business you want to integrate.

Select "Apps" under "Accounts" and find the App you are integrating on the page. On the top right corner, find "", which will open a new page.

Navigate to and find the app you want to connect to and click on it.

learn more about creating apps
display name guidelines
Meta Business Suite
Meta Business Suite
Business Manager
Open in App Dashboard
App Dashboard