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
Advanced Group Features
Add Participant as Customer
- Open the group chat
- Find a message from a participant (left side)
- Click the menu (⋯) on the message
- Select "Add as customer"
- Complete registration and start a private conversation
Delete Messages from Others
Group administrators can delete inappropriate messages from other participants:
- Click the menu (⋯) on the message
- Select "Delete message"
Group Photo
The group photo is automatically displayed in the chat header.
Participant List
- In the group chat header, click "Participants"
- View all members
- Use "Add as customer" for those with available numbers
ℹ️ Privacy (Meta)
Some participants appear only with an identifier (@lid due to Meta policies). In those cases, use the message menu when the participant sends something in the group.
Block Media in Groups
Prevent receiving media (images, videos, etc.) in groups:
- Go to Settings → Channels → your WAHA channel
- Enable "Block media in groups"
Close Group Conversation
You can close/resolve group conversations the same way as individual chats.
Permissions
| Setting | Description |
|---|---|
| Enable groups | Admin can enable/disable per channel |
| Block media | Prevents receiving files in groups |
Limitations
- Only messages received after connection
- Cannot create groups through platform
- Admin needs to add number to group
Auxiliary Channel for WhatsApp Official
If you use WhatsApp Official (Meta API), configure a WAHA auxiliary channel to overcome its natural limitations.
What it's for
| Official Limitation | Solution via Auxiliary Channel |
|---|---|
| Doesn't record messages sent from phone | Captures echoes (fromMe=true) and records in history |
| 24h window expires and blocks free messages | "Send via Auxiliary Channel" button appears in chat footer |
| Doesn't support groups | Auxiliary channel can receive/reply to groups |
| Doesn't expose contact profile photos | WAHA fetches the photo automatically |
How to configure
- Go to WhatsApp Official channel settings
- Scroll to WAHA Auxiliary Channel section
- Click "Add WAHA auxiliary channel"
- Scan the QR code with the phone's WhatsApp — must be the same number as the official channel, in Coexistence Mode
- Adjust settings:
- Listen to customer messages — disabled by default (avoids duplication with official)
- Listen to my messages — enabled by default to capture echoes
- Enable groups and Block media in groups
Sending outside the 24h window
- When the window expires, the chat footer shows "Use Template" and "Send via Auxiliary Channel"
- Click "Send via Auxiliary Channel"
- The full message input appears (text, files, audio, emoji)
- The message is sent via WAHA and recorded normally in the chat history
💡 Note
The auxiliary channel doesn't appear in the general channel listing — it's only visible inside the official channel settings.
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