WhatsApp WAHA
Connect your WhatsApp via QR Code for simplified service.
Overview
WAHA integration allows you to use your regular WhatsApp number on the Interflow platform. It's a practical solution for small and medium businesses.
Requirements
- [x] Active WhatsApp number
- [x] Phone with WhatsApp installed (for initial scanning)
Advantages
| Feature | Description |
|---|---|
| Simple | Connect via QR Code in minutes |
| No Meta costs | No per-conversation charges |
| Groups | WhatsApp groups support |
| Full media | Images, videos, audios, documents |
| Sync | Recover historical messages |
Limitations
ATTENTION
This integration is not official from Meta and may be subject to blocks. Use in moderation and follow best practices.
- Does not support approved templates
- Risk of blocking if used for spam
- Needs to keep session active
Configuration
Step 1: Add Channel
- In Interflow, go to Settings → Channels
- Click "Add channel"
- Select WhatsApp (WAHA)
Step 2: Scan QR Code
A QR Code will be displayed. Scan with your WhatsApp:
- Open WhatsApp on your phone
- Go to Settings → Linked devices
- Click "Link a device"
- Scan the QR Code
Step 3: Confirm Connection
After scanning, status will change to Connected. You can now receive and send messages through Interflow.
Keeping Session Active
To avoid disconnections:
- ✅ Keep phone connected to internet
- ✅ Don't manually disconnect the device
- ✅ Avoid using same number on other services
- ❌ Don't logout from WhatsApp on phone
Message Sync
Recover historical WhatsApp messages that didn't enter automatically.
How to use
- Open a WAHA chat
- Click on menu (⋮) → "Sync Messages"
- Configure the period:
- Start Date and End Date
- Maximum limit: 3 days per sync
- Click "Sync"
What happens
- ✅ Fetches messages from selected period
- ✅ Syncs with original timestamp
- ⏭️ Ignores existing messages
- ✅ Updates correct status (sent, delivered, read)
💡 When to use
Useful when you reconnected the channel and want to recover conversations that happened while disconnected.
WhatsApp Groups
Receive and respond to messages from WhatsApp groups.
How it works
- 💬 Groups appear in conversation list
- 👤 Identifies who sent in the group
- ↩️ Respond directly to group
- 📊 Complete history preserved
Permissions
| Setting | Description |
|---|---|
| Enable groups | Admin can enable/disable per channel |
| Restrict agents | Agents can be blocked from groups |
Limitations
- Only messages received after connection
- Cannot create groups through platform
- Admin needs to add number to group
Best Practices
To avoid WhatsApp blocks:
✅ Do
- Send messages only to those who authorized
- Respond quickly to customers
- Use professional language
- Have a service schedule
❌ Avoid
- Sending unsolicited mass messages
- Using aggressive promotional language
- Sending many messages in sequence
- Starting conversations with strangers
Reconnection
If channel disconnects:
- Check status in Channels
- Click on disconnected channel
- Scan new QR Code
- Wait for reconnection
TIP
If disconnections are frequent, check phone's internet connection and consider migrating to WhatsApp Business API.
Troubleshooting
QR Code doesn't appear
- Clear browser cache
- Try in incognito window
- Check for firewall blocks
Frequent disconnection
- Check phone's internet
- Update WhatsApp to latest version
- Avoid multiple connected sessions
Messages don't arrive
- Confirm number is correct
- Verify channel is connected
- Check if webhooks are configured
Next Steps
- Chat Interface - Use Quick WhatsApp Button
- Flow Automation - Automate services
- AI Agents - AI to respond to groups
- WhatsApp Business - Migrate to official API