Connect WhatsApp
Connect your WhatsApp Business account to send and receive messages through Qwetty. You can connect using an existing WhatsApp Business App or set up a new connection via the WhatsApp Cloud API.
Prerequisites
- A Meta Business Account
- Admin access to your Qwetty organization
Connection methods
Option 1: Embedded Signup (recommended)
Qwetty guides you through Meta's Embedded Signup flow. This works for both new WhatsApp Business accounts and existing WhatsApp Business App users.
- Go to Settings → Channel
- Click Create Channel and select WhatsApp
- Enter a name for your channel and save
- Select the Embedded Signup tab
- Click Connect with Facebook
- Sign in to your Meta Business account and follow the prompts
- Select or create a WhatsApp Business Account (WABA)
- Select or register a phone number
- Complete the verification process
Once connected, your channel status will show as Connected and you can start receiving messages.
Connecting an existing WhatsApp Business App
If you're already using the WhatsApp Business App on your phone, you can connect it to Qwetty through the same Embedded Signup flow. During the signup process, select your existing WhatsApp Business account and phone number.
When connecting an existing WhatsApp Business App:
- Qwetty operates in coexistence mode — your WhatsApp Business App continues to work alongside Qwetty
- Qwetty will automatically sync your existing contacts and chat history
- Keep the WhatsApp Business App open during the initial sync
Note: Coexistence mode has a throughput limit of 20 messages per second.
Option 2: Manual Configuration (Cloud API)
If you already have WhatsApp Cloud API credentials from the Meta App Dashboard, you can enter them manually:
- Go to Settings → Channel
- Click Create Channel and select WhatsApp
- Enter a name for your channel and save
- Select the Manual Entry tab
- Enter your credentials:
- Phone Number ID
- WhatsApp Business Account ID (WABA ID)
- System User Access Token
- Save and verify the connection
Quality rating
Meta assigns a quality rating to your WhatsApp number based on how recipients interact with your messages. You can view your current quality rating in Settings → Channel → [Your Channel] → Details → Overview.
| Rating | Meaning |
|---|---|
| Green | High quality |
| Yellow | Medium quality |
| Red | Low quality (messaging may be restricted) |
To maintain a good quality rating:
- Use approved message templates for outbound conversations
- Avoid sending unsolicited messages
- Ensure customers have opted in to receive messages
Messaging window
WhatsApp has a 24-hour messaging window. After a customer messages you, you have 24 hours to send free-form messages. After the window closes, you can only send approved message templates.
See Channel Limitations for more details on messaging windows.
Troubleshooting
| Issue | Solution |
|---|---|
| Channel stuck on "Connecting" | Try disconnecting and reconnecting through Embedded Signup |
| Messages not arriving | Ensure your channel is in the Connected state in Settings → Channel |
| "Phone number already registered" | The number may be registered with another WhatsApp Business API provider — deregister it first |
| Quality rating dropped | Review your message templates and sending patterns |
| Coexistence sync not completing | Keep the WhatsApp Business App open and ensure a stable internet connection |
Next steps
- Channel Dashboard — Monitor your WhatsApp channel health
- Channel Limitations — Understand messaging windows and restrictions
- Message Templates — Create templates for WhatsApp outbound messaging
- WhatsApp Template Sync — Sync templates from Meta