Active sessions - Beem API

MOJA session messages can only be sent to users with an active session — a conversation where the user has interacted with your business within the last 24 hours (the WhatsApp 24-hour rule). Use the Get active sessions endpoint to see who you can message right now.

24-hour session rule

Businesses may send free-form session messages only when the user has sent a message (or otherwise engaged) within the last 24 hours on that channel. Outside that window, you must use an approved WhatsApp template via Send template message.

User messages your business
        │
        ▼
24-hour session opens
        │
        ▼
You can send session messages (POST /v1/chatapi)
        │
        ▼
After 24 hours of inactivity → use templates only

Retrieve active sessions

Call GET /v1/chatapi/active-users to list active sessions for the authenticated vendor. Each item includes:

Field	Description
`sesssion_start_time`	When the session started
`channel`	Channel type (e.g. `whatsapp`)
`from_addr`	User address you can reply to
`username`	Display name when available
`last_message`	Most recent message in the session

The response field is spelled sesssion_start_time (three s) in the API — match this exactly when parsing.

Typical workflow

Call Get active sessions to find users you can message.
Use the from_addr value as the to field in Send session message.
Optionally set callback_url to receive inbound replies at your server.