Skip to main content

​
Sessions

A session is one WhatsApp linked device managed by WADial.

​
Tokens

The dashboard presents sessions as tokens. Each token has a stable sessionId that your application uses in API paths. You do not choose the sessionId. WADial creates it when the token is created and returns it in the response.

​
Pairing and connection state

A token can stay paired even when it is not currently connected.
  • paired means WhatsApp is linked to the token.
  • active means WADial is preparing or maintaining a live connection for the token.
  • connected means the token is ready to send messages and place calls.
  • connectionState describes the current connection state. If it is inactive, reconnect the token before sending.
If a paired token has connected: false, call POST /api/v1/sessions/{sessionId}/connect to reconnect it. Do not request another pairing code for an already paired token.

​
Capacity

Capacity is the number of purchased WhatsApp session slots that are currently available or assigned.

​
Billing period

Each purchased slot expires exactly 30 days after its payment succeeds. A new purchase creates a new slot and does not extend an existing session. Every token shows its own expiry time.