Skip to content

Connection

Connect WhatsApp devices and WABA numbers, copy tokens, and fix linking failures.

9 min read

Connect a WhatsApp device or WABA number before sending. Each section below is a numbered task — follow the steps, check You should see, then continue.

WhatsApp — check your account token first

Do this once if Channel → WhatsApp → Devices shows no rows or you are not sure Kirisan can see your devices:

  1. Open Channel → WhatsApp → Token, add or update your Fonnte account token, then save.
  2. Go back to Channel → WhatsApp → Devices and click Refresh.
  3. If a Fonnte account dropdown appears, pick the account that owns the device and click Refresh again.

Before you start — click Refresh after saving your account token

You should see at least one device row after the refresh.

Add and connect a WhatsApp device

Goal: Register a new WhatsApp number and link it by scanning QR.

  1. Open Channel → WhatsApp → Devices and click Add Device in the page header.

Step 1 — click Add Device in the header

  1. Enter a Name (for example Sales) and the Device number with country code, no + (for example 6281234567890). Click Add Device.

Steps 2–4 — fill name and number, then Add Device

  • You should see a new row with Status disconnect.
  1. Click Connect on the new row and follow the steps in Connect a disconnected device below.

Done when: The row shows Status connect.

Connect a disconnected WhatsApp device

Goal: Turn a red disconnect badge into green connect.

Start when: The device row shows Status disconnect.

  1. On the device row, click Connect.

Step 1 — click Connect on the disconnect row

  • You should see the Connect WhatsApp modal with QR code and Pairing code tiles.
  1. Click the QR code tile.

Step 2 — choose QR code

  • You should see a QR code image. Leave the modal open.
  1. On the phone that owns this WhatsApp number, open WhatsApp → Linked devices (Android: ⋮ menu; iPhone: Settings).

Step 4 — WhatsApp Linked devices screen; tap Link a device

  1. Tap Link a device, then point the camera at the QR on screen.

  2. Keep the Kirisan modal open for up to 55 seconds.

Step 5 — success toast and green connect status

  • You should see toast Device connected successfully. and the row Status change to connect.

Done when: Status is connect and you can send a test from Send → Send.

Pairing code (if QR fails)

Use this if the camera cannot scan the screen or QR times out.

  1. Click Connect → Pairing code tile.
  2. Enter the device number (country code, no +) and click Get code.

Code step — enter phone number and click Get code

  • You should see an 8-digit code in the modal.

Code step 4 — enter this code in WhatsApp on your phone

  1. On the phone: WhatsApp → Linked devices → Link with phone number instead, enter the 8-digit code.
  2. Wait up to 55 seconds without closing the modal.

Done when: Status is connect.

Reconnect or disconnect a WhatsApp device

Reconnect (refresh a live session)

Start when: Status is already connect but messages feel delayed or stale.

Click Reconnect on the row.

Reconnect — click Reconnect on a connect row

  • You should see toast Reconnect requested. Wait a few seconds, then send a test.

If it still fails: Disconnect the device, then connect again with QR or pairing code.

Disconnect (pause without deleting)

Start when: Status is connect and you want to pause without removing the row.

Click Disconnect, then confirm.

Disconnect — result toast and red disconnect status

  • You should see Status change to disconnect. The row stays in the table — click Connect again when ready.

Delete permanently

Click Delete and confirm the dialog. This cannot be undone.

Delete — confirmation dialog

Prefer pausing? Use Disconnect instead.

Connect a WABA number (Connect with Meta)

Goal: Link a WhatsApp Business number to Kirisan via Meta while keeping the WhatsApp Business app on your phone.

Before you start:

  1. Update WhatsApp Business on the phone to v2.24.17 or later.
  2. Confirm the number is active in the WhatsApp Business app.
  3. Know the Meta account (Facebook login) that manages the business owning the number.

Before you start — update WhatsApp Business

Step 1 — Start Meta signup

  1. Open Channel → WABA → Devices. Click Connect with Meta.

Step 1 — click Connect with Meta

  • You should see the button change to Connecting…, then a Meta login window opens (popup or new tab). If nothing appears, see Fix common problems below.
  1. Log in with the Meta account that manages your WhatsApp Business number.

Step 3 — sign in with your Meta account

Step 2 — Pick your business

  1. When Meta asks for a Business Portfolio, choose the one that owns the number, then click Continue.

Step 4 — select your Meta business portfolio

Step 3 — Select your phone number

  1. Pick the number from the list. Meta shows a coexistence note — your WhatsApp Business app keeps working.

Step 5 — select your number

  1. Click Finish (or Continue / Done). Do not close the Kirisan tab while Meta processes.

Step 4 — Save your API token

  1. Back on Kirisan, a green banner shows your API token.

Step 6 — copy and save your API token

  • You should see toast Connected <name> · +62 …
  1. Click Copy token and store it safely. Confirm the number appears as a new row in the table.

Step 7 — new row in the WABA Numbers table

Done when: The number is in the table and you have the token saved.

Next: Sync templates under Channel → WABA → Templates, then send a test from Send → Send.

Reconnect a disconnected WABA number

Open Channel → WABA → Devices and run Connect with Meta again with the same Meta account and phone number. Kirisan registers a new token — copy it from the success banner.

Copy a device API token

WhatsApp

  1. Open Channel → WhatsApp → Devices.
  2. In the Token column on the correct row, click .

Copy token — click the icon in the Token column

  • You should see toast Device token copied to clipboard.

The Token column shows a short preview. The copy icon always gives the full token.

Note: This is the device token (for sending), not the Fonnte account token on Channel → WhatsApp → Token.

WABA

  1. Open Channel → WABA → Devices.
  2. In the API token column, click on the row.

Copy WABA token from the table row

  • You should see a confirmation toast.

The full token is always available here — even if you dismissed the success banner after connecting.

Fix common problems

WhatsApp device list is empty

Symptom: You clicked Refresh but the table has no rows.

  1. Open Channel → WhatsApp → Token and confirm an account token is saved.
  2. If Fonnte account appears in the header, select each account one by one and click Refresh after each.
  3. Log in to Fonnte directly — if the device exists there, click Add Device in Kirisan with the same number, then Connect.

QR times out or never completes

Symptom: Modal closes after ~55 seconds; toast says linking timed out.

  1. Confirm the phone number on the row matches the SIM in the phone you are scanning with.
  2. On the phone: WhatsApp → Linked devices — remove old or unknown linked devices, then try again.
  3. Try Pairing code instead of QR.
  4. Keep the Kirisan tab in the foreground until you see Device connected successfully.

Status stays disconnect after linking

  1. Click Refresh on the Devices page and wait for the table to reload.
  2. If still disconnect, click Connect and try again from the start.
  3. Click the Package badge — if Expires is expired or Quota is 0, renew under Billing → Order first.

Copy token does nothing

  1. Click once on the page background, then click the copy icon again (browsers require a direct click).
  2. Allow clipboard access for dash.kirisan.com in browser settings.
  3. You should see toast Device token copied to clipboard. then paste with Ctrl+V / Cmd+V.

WABA — Connect with Meta is greyed out

  1. Refresh the page. If a red message appears in the info note, contact support.
  2. Try Chrome or Edge with popups allowed for dash.kirisan.com.

WABA — clicking Connect with Meta does nothing

  1. Allow popups for the Kirisan dashboard in your browser.
  2. Disable ad blockers temporarily for this site.
  3. Check the address bar for a popup-blocked icon and click Allow.

WABA — “WhatsApp signup did not return a WABA ID”

  1. Run Connect with Meta again and complete all steps through Finish without switching tabs.
  2. Confirm you selected a phone number (not only the business portfolio) on the Meta screen.
  3. Make sure the number is on WhatsApp Business app v2.24.17+.

WABA — lost token after connecting

Follow Copy a device API token — WABA above. The full token is always on the row.

Last updated: July 2, 2026
Was this page helpful?