WhatsApp Configuration

​

Introduction

​

Prerequisites

• A WhatsApp Business account
• Access to Meta for Developers (https://developers.facebook.com/)
• Admin access to your Facebook Business account
• A verified phone number for your business

​

Step 1: Collect Required Credentials and Configure Swiftsell

​

Access Meta for Developers

1. Go to Meta for Developers
2. Log in with your Facebook account
3. Navigate to “My Apps” or create a new app if you haven’t already
4. Select your existing app or create a new “Business” type app
5. Add the WhatsApp product to your app
6. Navigate to the WhatsApp > API Setup section

​

Collect Credentials

​

Configure Swiftsell

1. Navigate to Settings > WhatsApp in your Swiftsell dashboard
2. Click + WhatsApp Configuration to open the connection form
3. Enter your WhatsApp Business Phone Number in the designated field
4. Enter your App ID in the designated field
5. Enter your Phone Number ID in the corresponding field
6. Enter your WhatsApp Business Account ID in the designated field

​

Step 2: Create System User Access Token

​

Access Business Settings

1. Go to Meta Business Suite
2. Log in with your Facebook account
3. Locate your business portfolio in the top-left dropdown menu
4. Click the Settings (gear) icon next to your business portfolio name

​

Create System User

1. In the Business Settings panel, click System Users in the left sidebar under “Users”
2. Click the +Add button
3. In the Create system user window:
   • Enter a system user name (e.g., “SwiftSell Integration”)
   • Assign it an Admin role (recommended for full access to all WABAs)
   • Click Create

​

Assign App Assets to System User

1. Once the system user is created, click on the system user’s name to open the asset assignment overlay
2. Click the Assign assets button
3. In the Select assets and assign permissions window:
   • Select your WhatsApp Business App
   • Grant the system user Manage app permission
   • Click Assign assets to confirm
4. Important: Reload the page and wait a few minutes for permissions to be granted. The system user should show Full control of your app.

​

Generate Access Token

1. In the asset assignment overlay, click the Generate token button
2. In the token generation window:
   • Select your WhatsApp Business App from the dropdown
   • Choose a token expiration preference (60 days or Never expire - recommended)
   • Select the following Graph API permissions:
     • business_management
     • whatsapp_business_management
     • whatsapp_business_messaging

3. Click Generate token
4. Critical: Copy the generated token immediately and store it securely - you won’t be able to see it again
5. Add this token to the Token field in your SwiftSell configuration form

​

Step 3: Save Configuration and Set Up Webhook

1. Complete all fields in the SwiftSell WhatsApp configuration form
2. Click Save to save your configuration
3. After saving, SwiftSell will provide you with:
   • Webhook URL (e.g., https://api.swiftsell.com/whatsapp/webhooks/674eb212f6b...)
   • Verify Token (a unique token for webhook verification)

​

Configure Webhook in Facebook App

1. Return to your Meta for Developers dashboard
2. Navigate to WhatsApp > Configuration
3. In the Webhooks section:
   • Enter the Webhook URL provided by SwiftSell
   • Enter the Verify Token provided by SwiftSell
   • Select the following webhook fields:
     • messages
4. Click Verify and Save
5. Subscribe to webhook events by clicking Manage and selecting your webhook fields

​

Step 4: Test Your Connection

1. Use the “Send message” button in the Meta developer dashboard to send a test message
2. Verify that messages are being received in your SwiftSell dashboard
3. Try sending a message from SwiftSell to confirm bidirectional communication
4. Check that message status updates (delivered, read) are working correctly