QUALI-D Logo
English
العربية

🚀 QUALI-D WhatsApp API Integration

Complete step-by-step guide to connecting your WhatsApp Business API

Step 1 of 3: Create Meta App
1.1

Access Meta for Developers

Navigate to Meta for Developers and sign in with your Facebook account.

You must have a Facebook Business Manager account. You'll be prompted to create one if needed.
Step 1 of 3: Create Meta App
1.2

Create a New App

  1. Click "My Apps" in the top right
  2. Click "Create App"
  3. Select "Business" as app type
  4. Click "Next"
Create App page with Business type selected
Step 1 of 3: Create Meta App
1.3

Configure App Details

Fill in your application information:

  • App Name: Use YOUR business name
  • Contact Email: Your business email
  • Click "Next" to proceed
Use your actual business name. This app belongs to you and connects to QUALI-D.
Step 1 of 3: Create Meta App
1.4

Select Use Case

Choose how you plan to use your Meta app:

  1. Select "Connect with customers through WhatsApp"
  2. Click "Next"
Use case selection with WhatsApp option
This tells Meta you're setting up a WhatsApp Business integration.
Step 1 of 3: Create Meta App
1.5

Choose Business Portfolio

Select or create a Business Portfolio:

  • Choose an existing Business Portfolio if you have one
  • Or click "Create a new Business Portfolio" (Learn how to create one)
  • Click "Next"
A Business Portfolio organizes your business assets like apps, ad accounts, and pages.
Step 1 of 3: Create Meta App
1.6

Review and Confirm

Review your setup on the Overview page:

  1. Review all the information you entered
  2. Make sure everything is correct
  3. Click "Go To Dashboard" to complete the setup
This will take you to your app dashboard where you can add WhatsApp.
Step 1 of 3: Create Meta App
1.7

Customize WhatsApp Use Case

From your app dashboard:

  1. Look for "App customization and requirements" section
  2. Click "Customize the Connect with customers through WhatsApp use case"
  3. You'll be taken to the use case customization page
This is where you configure WhatsApp Business Platform settings for your app.
Step 1 of 3: Create Meta App
1.8

Accept Terms and Select Business Portfolio

Configure WhatsApp Business Platform settings:

  1. Read and click "Accept Terms of Service" for WhatsApp Business Platform
  2. Under "WhatsApp Business Platform", your Business Portfolio should be pre-selected
  3. Review the note about receiving a test phone number (max 5 numbers)
  4. Click "Continue" at the bottom
You agree to Facebook Terms for WhatsApp Business and Meta Hosting Terms for Cloud API.
Step 1 of 3: Create Meta App
1.9

Start Using the API

Welcome to WhatsApp Business Platform setup:

  1. You'll see "Welcome to the WhatsApp Business Platform"
  2. Read about sending and receiving messages using Cloud API
  3. Under "API Setup", click "Start using the API"
  4. This takes you to the API configuration page
Meta hosts the WhatsApp Business API client on cloud-based servers for you.
Step 2 of 3: Get Phone Number ID
2.1

Copy Your Phone Number ID

On the API Setup page, you'll see your test configuration. You'll need to enter this Phone Number ID in your QUALI-D dashboard:

  1. Scroll to "Step 1: Select phone numbers"
  2. Under the "From" section, you'll see a test phone number
  3. Find "Phone number ID:" with a numeric ID below it
  4. Click the copy button next to the Phone Number ID
  5. Save this ID - you'll enter it in the QUALI-D dashboard under WhatsApp Settings
  6. Also note the "WhatsApp Business Account ID" - you'll need this for token generation
API Setup page showing Phone Number ID
The Phone Number ID is different from your actual phone number. This is a unique identifier for API calls.
Test phone numbers let you send free messages for 90 days to up to 5 numbers.
Step 3 of 3: Generate Access Token
3.1

Create System User

Create a System User for permanent token:

  1. Navigate to "Business Settings"
  2. Select "System Users"
  3. Click "Add"
  4. Name it (e.g., "WhatsApp Integration")
  5. Set role to "Admin"
  6. Click "Create"
Step 3 of 3: Generate Access Token
3.2

Assign Assets

  1. Click the new system user
  2. Click "Add Assets"
  3. Select "Apps"
  4. Choose your app
  5. Enable "Manage App"
  6. Click "Save"
Step 3 of 3: Generate Access Token
3.3

Generate Token

  1. Click "Generate New Token"
  2. Select your app
  3. Select permissions: whatsapp_business_management, whatsapp_business_messaging, whatsapp_business_templates, business_management
  4. Set expiration to "Never"
  5. Click "Generate"
  6. Copy immediately! You won't see it again
  7. Enter this token in the QUALI-D dashboard under WhatsApp Settings along with your Phone Number ID
Security Warning: This token provides full API access. Never share publicly or commit to version control. Only enter it in your QUALI-D dashboard.
Step 4 of 4: Configure Webhooks
4.1

Get Webhook Details from QUALI-D Dashboard

Before configuring webhooks in Meta, you need to get the webhook URL and verify token from your QUALI-D dashboard:

  1. Go to your QUALI-D Dashboard
  2. Navigate to WhatsApp Settings
  3. Enter the Access Token and Phone Number ID you copied earlier
  4. The system will automatically generate a unique Webhook URL and Verify Token for you
  5. Copy both the Webhook URL and Verify Token - you'll need them for the next step
QUALI-D automatically generates unique webhook credentials for your account. These are dynamically created to ensure secure communication.
Step 4 of 4: Configure Webhooks
4.2

Configure Webhook in Meta

Now configure the webhook in your Meta WhatsApp app:

  1. Go back to your Meta app dashboard at developers.facebook.com
  2. Select your app and go to WhatsApp > Configuration
  3. In the Webhook section, click "Edit"
  4. Paste the Webhook URL from QUALI-D dashboard
  5. Paste the Verify Token from QUALI-D dashboard
  6. Click "Verify and Save"
  7. Subscribe to webhook fields: messages, message_status
Once verified, Meta will start sending WhatsApp events to your QUALI-D system in real-time!