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.
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 |
| Manual Replies | Reply from Unified Inbox after risk acknowledgement; not for broadcast or automatic sending |
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 |
| Manual Inbox replies | ✅ Yes | Available after risk acknowledgement; avoid bulk patterns |
| Bulk chatbot / auto-reply | ❌ No | Session does not provide a safe or compliant automation channel |
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 manual replies | ✅ Possible, high risk | ✅ Yes |
| Chatbot / official templates | ❌ Unavailable | ✅ Yes |
| 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: Session can send manual replies from Unified Inbox after risk acknowledgement. Automatic sending, bulk chatbots, and broadcasts are not supported; use the official channel for automation.
Q: How many numbers can be connected? A: It depends on your Konektor plan. Check the session limit in the Pricing section.
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: Account safety is not guaranteed. Session is not an official API and may violate Meta terms, so an account can be restricted or blocked. Read the Session risk guide before enabling it.
Need More Help?
Our team is ready to help you maximize ad tracking and business attribution.
© 2026 Konektor. All rights reserved.