Skip to main content

​
Sessions

A session is one WhatsApp linked-device runtime managed by WADial.

​
Tokens

The dashboard presents sessions as tokens because developers use the session id as the stable handle for API operations.

​
Pairing and runtime state

A token can stay paired even when the live runtime is not connected.
  • paired means WhatsApp credentials exist for the token.
  • active means WADial currently has a runtime loaded for the token.
  • connected means the runtime is connected and ready to send messages.
  • connectionState describes the current runtime state. If it is inactive, the token was previously connected but no live runtime is currently attached.
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 WhatsApp sessions a user can create for the current month. The minimum purchase is 50 sessions.

​
Expiry

Session capacity lasts one month from successful payment. When payment succeeds, WADial updates:
  • maxActiveSessions
  • expiresAt
  • user active status