WhatsApp Session (Scan QR)
WhatsApp Session is a Konektor feature that lets you connect a regular WhatsApp Business number (not WA API) to Konektor via QR Code Scan, similar to opening WhatsApp Web in a browser.
Important
This feature uses WhatsApp Web (Linked Device) technology. You do not need a WhatsApp Business API subscription or any partner. Just have a regular WhatsApp Business app on your phone, then scan the QR from the Konektor dashboard.
What Can Session Do?
Once your WA number is connected via Session, Konektor can:
| Capability | Description |
|---|---|
| Detect Incoming Chats | Automatically detect new messages from customers |
| Auto-Create Leads | When a customer sends their first message, a lead is automatically created in the dashboard |
| Detect CTWA | Automatically recognize chats from Click to WhatsApp ads |
| Send Conversion Events | Automatically send a Lead event to Meta Pixel when the first chat comes in |
| Automation Rules | Run automated rules based on message content (keyword, regex, status) |
| Online/Offline Status | See whether a CS number is active or not |
| Unique Code Tracking | Detect unique codes (e.g., K-WPA4N) from customer pre-filled messages |
When Do You Need Session vs Not?
| Need | Session Required? | Explanation |
|---|---|---|
| Split traffic to CS (Rotator) | ❌ No | Rotator only redirects links, no WA connection needed |
| Track ad clicks | ❌ No | Tracking happens on the server when the link is clicked |
| Detect incoming chats & auto-create leads | ✅ Yes | Session is needed so Konektor can "read" messages |
| Send conversion events to Meta from chat | ✅ Yes | Session is needed to detect the first chat |
| Message-based automation rules | ✅ Yes | Session is needed to read message content |
| Chatbot / auto-reply | ❌ Needs Partner | Session cannot send messages, only read them |
How to Set Up WhatsApp Session
1. Open the Session Menu
Go to your workspace dashboard, then open WhatsApp > Session from the sidebar.
2. Scan QR Code
- Click Add Session to create a new session, fill in the name then click Create Session.
- Click Start Session on the newly created session.
- Click Show QR to display the QR code.
- Open the WhatsApp Business app on your phone.
- Go to Settings > Linked Devices > Link a Device.
- Scan the QR code displayed on the Konektor dashboard.
- Wait until the status changes to Connected.
3. Verify Connection
After a successful scan:
- The status will change to Connected (green).
- Last Sync will show the most recent sync time.
- Your WA number will appear in the session list.
Troubleshooting
Unique Code Not Showing in Dashboard
If a customer has sent a message with a unique code (e.g., K-WPA4N) but the lead doesn't appear in Konektor:
- Check Session status — Open WhatsApp > Session. Make sure the status is Connected (green).
- Check Last Sync — Ensure the Last Sync time is recent (no more than a few minutes ago).
- Reconnect if needed — If the status is Disconnected or Last Sync is stale, click Start Session and scan the QR again.
- Check Automation Rules — Make sure there's an active rule to process incoming messages in WhatsApp > Rules.
Session Frequently Disconnects
- Make sure your phone stays connected to the internet (WiFi or mobile data).
- Make sure WhatsApp on your phone is not force-closed or restricted by battery saver.
- WhatsApp limits the number of Linked Devices. If the limit is reached, remove other unused devices.
Last Sync Not Updating
- Check your phone's internet connection.
- Try Reconnect from the dashboard.
- If the issue persists, delete the session and scan the QR again.
Conversion Events Not Sent to Meta
- Make sure the Pixel ID is set in the Conversion menu.
- Make sure the Session status is Connected.
- Check whether the lead has been created in the Leads menu — conversion events are sent when a lead is first created from a chat.
Session vs WhatsApp API
| Aspect | Session (Scan QR) | WhatsApp API (Partner) |
|---|---|---|
| Cost | Free (included in Konektor plan) | Paid (partner fees + per-message) |
| Setup | Scan QR, done in 1 minute | Requires BSP registration, business verification |
| Read incoming messages | ✅ Yes | ✅ Yes |
| Send messages / auto-reply | ❌ Not possible | ✅ Yes |
| Chatbot | ❌ Not possible | ✅ Yes (via partner) |
| Stability | Depends on phone connection | More stable (cloud-based) |
| Best for | Small-medium businesses, basic tracking | Large businesses needing chatbot & broadcast |
FAQ
Q: Can I use a regular WhatsApp Business (not API)? A: Yes, that's exactly what Session is for. Just have a regular WhatsApp Business app on your phone, then scan the QR from the Konektor dashboard.
Q: Can Session send automatic messages? A: No. Session can only read incoming messages. To send automatic messages (chatbot/auto-reply), you need to integrate with a WhatsApp API partner.
Q: How many numbers can be connected? A: It depends on your Konektor plan. Check the session limit on the Pricing page.
Q: Are old chats synced? A: No. Session only detects new messages that come in after the connection is active.
Q: Is it safe? A: Yes. Konektor uses WhatsApp's official Linked Device mechanism. Data is handled securely in line with Konektor's privacy policy.
Need More Help?
Our team is ready to help you maximize ad tracking and business attribution.
© 2026 Konektor. All rights reserved.