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:

When Do You Need Session vs Not?

How to Set Up WhatsApp Session

1. Open Numbers & CTWA

Go to your workspace dashboard, then open Connection > Numbers & CTWA from the sidebar.

2. Scan QR Code

1. Click Add Session to create a new session. The name is filled in as Konektor - workspace name; change it if needed. Select the box "I understand this method can violate Meta terms and the account can be blocked, and I still want to continue." Then click Create Session.
2. Click Start Session on the newly created session.
3. Click Show QR to display the QR code.
4. Open the WhatsApp Business app on your phone.
5. Go to Settings > Linked Devices > Link a Device.
6. Scan the QR code displayed on the Konektor dashboard.
7. Wait until the status changes to Connected.

3. Verify Connection

After a successful scan:

• The status will change to Connected (green).
• The Last Checked column shows the time of the last check.
• Your WA number will appear in the session list.
• On your phone, Linked Devices shows a device named Konektor.id. Do not log out that device, or chats stop reaching Konektor.

A QR number can also change a lead status when the lead joins your WhatsApp group. See track ads to a WhatsApp group.

When Is a Lead Created?

The lead creation rule differs by path. Automation Rules do not create leads.

A WhatsApp Link click also creates a Visitor [CODE] lead with the status New and no phone number. The number fills in when the coded chat arrives. Read Visitor identification.

Set up CTWA

CTWA sends conversions from Click-to-WhatsApp ads to Meta. Open its setup from the session or number in the list on the Numbers & CTWA page.

1. Click Set up CTWA. If it is already set, the button reads Manage CTWA.
2. Step 1: enter the WhatsApp Business Account ID (WABA ID). This is the numeric ID of the business account that owns the number.
3. Step 2: under Connect your Meta account, click Log in with Meta. Meta login is the main method. Follow the Meta CTWA guide.
4. Read the status hint under the title. It names the next step, such as entering the WABA ID or reconnecting the Meta account.

When done, the status changes to CTWA configured. This status only checks the settings in Konektor. Meta accepts the event when it is actually sent.

Other buttons in this window: Check connection, Replace token, and Disconnect CTWA. Disconnect CTWA only disconnects the number in Konektor. The token at Meta is not revoked.

Use a Connected Number (for CTWA)

A number that a partner (for example Kapso, Kirimdev, or Qontak) or the official WhatsApp Business API already connects needs no QR scan. Add that number to this page to set up its CTWA.

1. Open Connection > Numbers & CTWA.
2. Click Use a connected number. The button shows only when the workspace has a partner or official number that is not added yet.
3. Pick the number. The label under its name shows the partner.
4. If asked, enter the WhatsApp number with the country code, for example 62812345678.
5. Click Use this number. The CTWA setup opens at once.
6. Enter the WABA ID, then connect your Meta account as for a QR session.

Result:

• The number shows in the list with the label Via {partner name} and the status Managed by {partner name}.
• The number has no QR and does not use your QR session quota.
• Conversion events from Click-to-WhatsApp ad chats to this number go to the CTWA dataset you set up.

For an official WhatsApp Business number, the WABA ID is already filled in. After an official or partner connection succeeds, the Set up CTWA for this number button also opens this panel.

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:

1. Check Session status — Open Connection > Numbers & CTWA. Make sure the status is Connected (green).
2. Check Last Checked — Make sure the time in the Last Checked column is recent (no more than a few minutes ago).
3. Reconnect if needed — If the status is Disconnected or the Last Checked time is old, click Start Session and scan the QR again.
4. Check the message — Make sure the customer sent a message that holds that code. A QR session creates a lead only from a coded message or a message with ad data. You do not need an Automation Rule to create a lead.

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 Checked Does Not Change

• Check your phone's internet connection.
• Click Start Session, then scan the QR again.
• If the issue persists, delete the session and scan the QR again.

Conversion Events Not Sent to Meta

• Make sure Meta is added in Website Tracking and set your events in the Conversions menu. Check the Delivery log in Tracking & Ads > Conversions.
• 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

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 itself does not send automatic messages. Your team replies manually with text from the Inbox after accepting the session risk warning once. Attachments and templates go out from the WhatsApp app on the phone. AI auto-reply is a separate feature in AI Wulan → Agent & model.

Q: Is a lead created from every message in Session? A: No. A QR session creates a lead only from a message that carries a visitor code [K-...] or Click-to-WhatsApp ad data. Official WhatsApp Business creates a lead from every new number.

Q: Is Session required? A: No. Start with an official path: Official WhatsApp Business, Kapso, or another partner. Session carries a risk that the number is restricted or blocked.

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.