WhatsApp Integration

After creating your Workspace, the next step is to connect your WhatsApp Business account to enable messaging features.

Prerequisites

Before connecting WhatsApp, ensure you have:

• ✅ Active Workspace (installed and accessible)
• ✅ WhatsApp Business Account (personal or business)
• ✅ Meta Business Account (for API access)
• ✅ Admin permissions on WhatsApp Business Account

---

1. Accessing WhatsApp Integration Page

From Dashboard

1. From the business page, navigate to "WhatsApp Integration" or "Integrations" → "WhatsApp"
2. If Workspace is not installed, you'll see a message requesting Workspace setup first with a "Setup Workspace" button
3. After creating Workspace, you'll see the list of available WhatsApp numbers

---

2. Adding a New WhatsApp Account

Method 1: Embedded Signup (Recommended)

This is the easiest and fastest way to connect your WhatsApp Business account:

1. From the WhatsApp Integration page, click "Create" or "Add WhatsApp Account"
2. You'll see the WhatsApp setup page
3. Click the "Connect with Facebook" or "Facebook Embedded Signup" button
4. A Meta Business login window will open
5. Log in with your Meta Business account credentials
6. Grant necessary permissions:
   • WhatsApp Business Account access
   • Business information access
   • Message management permissions
7. Select the WhatsApp Business Account you want to connect
8. After authorization, you'll be automatically redirected to the account details page

---

3. Completing Account Setup

After adding the account, you need to complete the following steps to enable all features:

Step 1: Subscribe to Webhooks (Subscribe to WABA)

1. From the account details page, you'll find the "Subscribe to WABA" card
2. Click the "Subscribe" button
3. Webhooks will be automatically subscribed to receive messages and events

Step 2: Register Phone Number

1. From the details page, you'll find the "Register Phone" card
2. Click the "Register" button
3. The phone number will be registered with WhatsApp Business API
4. After successful registration, the number status will change to "CONNECTED"

Step 3: Send Test Message

1. From the details page, you'll find the "Send Test Message" card
2. Enter the phone number you want to send a test message to
3. Click "Send"
4. If successful, you'll receive a message on the specified number

Step 4: Edit Business Profile

1. From the details page, you'll find the "Edit Business Profile" section
2. You can update:
   • Profile Picture: Must be at least 192x192 pixels
   • Address: Business address
   • Email: Business email
   • Description: Business description (max 512 characters)
   • Industry: Type of business
   • Websites: Website links
3. Click "Update" to save changes

---

4. Managing WhatsApp Numbers

From the main WhatsApp Integration page, you can:

1. View All Numbers: List of all connected WhatsApp numbers
2. Sync Numbers: Click "Sync WABA Numbers" button to sync numbers from Meta
3. Set Default: From the menu, select "Set as Default"
4. Assign to Branch: From the menu, select "Assign to Branch" to link the number to a specific branch
5. View Details: Click "View Details" to navigate to the details page

---

5. Webhook Configuration

For receiving messages and events, configure webhooks:

1. Navigate to "Webhooks" in WhatsApp Integration
2. Enter your webhook URL: https://[your-domain]/webhooks/whatsapp
3. Configure events to receive:
   • Messages
   • Message status updates
   • Sent
   • Delivered
   • Read
   • Failed
4. Verify webhook using the verification token
5. Save configuration

---

Quick Access Links

Access these pages directly from your dashboard:

• 📱 WhatsApp Integration - Manage WhatsApp numbers (replace {businessId} with your business ID)
• 📊 Business Dashboard - Return to dashboard (replace {businessId} with your business ID)
• ⚙️ Workspace Settings - Manage workspace (replace {businessId} with your business ID)

---

Next Steps

After successfully connecting WhatsApp:

👉 Connect Salla Store

---

Important Notes

---

Troubleshooting

Issue: Cannot Connect WhatsApp

Possible Causes:

• Workspace not installed
• Invalid API credentials
• Insufficient permissions
• WhatsApp Business Account not active

Solutions:

1. Ensure Workspace is installed and active
2. Verify API credentials from Meta Business
3. Check account permissions in Meta Business
4. Ensure WhatsApp Business Account is active
5. Review error messages for specific issues

Issue: API Test Fails

Solutions:

1. Verify Phone Number ID is correct
2. Ensure Access Token is valid
3. Check account permissions
4. Review error message

---

Support and Help

If you encounter any issues:

• 📧 Email: support@awalchat.com
• 💬 Live Chat: Available in the dashboard
• 📱 WhatsApp: Contact us directly via WhatsApp
• 📚 Complete Guide: Review the Setup Guide