Skip to content

WhatsApp devices

Connect and manage WhatsApp numbers via Fonnte.

7 min read

Open Channel → WhatsApp → Devices.

What this page is for

Each row is a WhatsApp device from your Fonnte account. Pick a connected device when sending from Send → Send, campaigns, schedules, or autoreply rules.

The list comes from your Fonnte account token — add one under Channel → WhatsApp → Token first, then click Refresh here. If you manage multiple Fonnte accounts, use the Fonnte account selector when it appears.

WhatsApp Devices — header, summary cards, search, device table, and pagination

Sample data shown.

Header controlWhat it does
RefreshReload devices and summary counts from Fonnte
Add DeviceRegister a new WhatsApp device in Fonnte (name + number)

Summary cards

Three cards show totals for the selected Fonnte account:

WhatsApp Devices summary cards — Devices, Connected, and Messages

CardMeaning
DevicesTotal WhatsApp devices on this Fonnte account
ConnectedDevices with status connect (ready to send and receive)
MessagesCumulative message count reported by Fonnte for the account

Search and filter

Search is field-based — click the search area first, pick which column to search, then type your query.

Search in popup — choose Name, Device, Token, or Package

StepWhat happens
1. Click searchA Search in popup opens — you must choose a field before typing
2. Pick a fieldName, Device, Token, or Package
3. TypeKirisan filters the table as you type (short debounce)

After you pick a field, the search bar shows the field name on the left (for example Name ▼). Click it to switch fields — changing the field clears the query.

Name search — field pill, query, and status filter

Search fieldMatchesMinimum length
NameDevice name that contains your query3 characters
DeviceWhatsApp number that contains your query3 characters
TokenDevice API token that contains your query3 characters
PackageFonnte package name that contains your query3 characters

If you type fewer than three characters, Kirisan waits until the minimum is met and shows a short hint under the search bar.

On the same row as search (to the right):

  • StatusAll statuses, Connected, or Disconnected

Device table

Each row is one WhatsApp device:

WhatsApp Devices table with status badges, package badges, quota, expiry, token copy, and row actions

ColumnMeaning
NameLabel for the device in Kirisan or Fonnte
DeviceWhatsApp number (Fonnte device id)
Statusconnect = linked (green badge); disconnect = needs linking again (red badge)
PackageFonnte plan — click the badge to open Device plan (see Package plan below)
QuotaRemaining send credits — Ultra and Master show Unlimited
ExpiresDays left on the Fonnte plan — Expired in red; under 5 days in amber
TokenTruncated device API token with a Copy token button
ActionsIcon buttons — see Row actions below

Pagination below the table appears when results span more than one page.

Package plan

Click any Package badge to open Device plan:

Device plan popup — plan name, device details, quota, expiry, and next steps

The popup includes:

SectionWhat it shows
HeaderStatus badge, Name, Device, and close ()
What this meansPlain-language summary of the Fonnte plan for this device
DetailsPlan, quota, expiry, and connection status
What to do nextRenew under Billing → Order, connect WhatsApp, or watch quota
Got itCloses the popup

Badge colors in the table:

BadgeMeaning
Green FreeFree plan with credits and a valid expiry
Red FreeFree plan expired or out of quota
Violet plan namePaid Fonnte plan (for example Lite, Ultra) — the badge shows the actual plan name

WhatsApp free badges reflect quota and expiry, not the active/parked free-slot model used on Telegram, WABA, and Email domains. Each connected WhatsApp device sends according to its own Fonnte plan.

Row actions

Icon buttons appear in the Actions column (and Copy token sits in the Token column). Which connection buttons you see depends on the row’s Status.

WhatsApp device row actions for connected and disconnected devices

When status is connect

ActionWhat it does
ReconnectAsks Fonnte to refresh the WhatsApp session without scanning QR again. Use when the device feels stale but should still be linked.
DisconnectEnds the WhatsApp session on Fonnte. Kirisan asks you to confirm first; the row stays in the list with status disconnect. You can Connect again later.
EditOpens Edit Device for Kirisan-only settings (name, contacts, Auto Read, inbound handler).
DeleteOpens a confirmation dialog, then permanently removes the device from Fonnte through Kirisan.

When status is disconnect

ActionWhat it does
ConnectOpens Connect WhatsApp so you can link the phone with a QR code or pairing code.
EditSame as above — Kirisan settings can be changed before or after linking.
DeleteSame as above — removes the device from Fonnte.

Copy token

In the Token column, click next to the truncated token. Kirisan copies the full device API token to your clipboard for Send → Send, the Send API, or your integration.

Add a device

Register a new device in Fonnte from Kirisan:

Add Device modal — name and device number

  1. Click Add Device in the page header.
  2. Enter a Name and Device number (country code, no +, e.g. 6281234567890).
  3. Click Add Device to save.
  4. On the new row, click Connect and complete linking so status becomes connect.

Connect WhatsApp

Click Connect on a row with status disconnect:

Connect WhatsApp modal — QR code or pairing code

  • QR code — scan with WhatsApp on the phone that owns the number.
  • Pairing code — enter your number, click Get code, then type the 8-digit code in WhatsApp.

Kirisan polls Fonnte for up to about 55 seconds until the device connects or times out. Read the Fonnte risk notice before linking.

Edit a device

Click Edit on any row:

Edit Device modal — contacts, Auto Read, and on incoming message handler

  • Basic — device number (read-only) and display name
  • ContactsAuto-add senders to group saves new inbound numbers into a contact group
  • Auto Read — when enabled, choose Personal, Group, and/or Quick Reply scopes
  • On incoming message — one handler when Auto Read is on: Autoreply, Flow, Spreadsheet, or Webhook

These settings are stored in Kirisan. Fonnte still owns connection and billing for the device.

Delete a device

Click Delete on any row:

Delete device confirmation

Confirm in the dialog to remove the device from Fonnte through Kirisan. This cannot be undone. Use Disconnect instead if you only want to pause the session without deleting the row.

Day-to-day checks

  • Status — disconnected devices cannot send or receive until you Connect again.
  • Package / quota / expires — click the Package badge for full plan details; renew under Billing → Order before credits run out or the plan expires.
  • Refresh — use after changing tokens on the Token page or linking a phone outside Kirisan.

Tasks & troubleshooting

Step-by-step guides and fixes (copy token, connect, disconnect, empty list, timeouts) are in WhatsApp devices — tasks & troubleshooting.

Last updated: June 14, 2026
Was this page helpful?