SautiDesk
SautiDesk API
Contacts

Check the WhatsApp reply window

GET
/v1/desk/contacts/{id}/whatsapp/window

Returns whether free-text WhatsApp messages can be sent to one of a contact's numbers right now. WhatsApp allows it for 24 hours after that number last wrote to your line. Pass number and from to pick the number and line.

Requires: desk.read scope, Converse licence.

Authorization

bearerAuth
AuthorizationBearer <token>

A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.

In: header

Path Parameters

id*string

The contact's id (a UUID).

Query Parameters

number?string

The customer's WhatsApp number, in international format.

from?string

Your WhatsApp number to check the window for.

Response

OK

Example

{  "open": false,  "closes_at": "2026-10-14T08:30:00Z",  "last_inbound_at": "2026-10-14T08:30:00Z",  "number": "+254712345678",  "from": "+254712345678"}
FieldTypeDescription
openrequiredboolean
closes_atrequiredstring (date-time) | null
last_inbound_atrequiredstring (date-time) | null
numberrequiredstringA phone number in international format, for example +254712345678.
fromstringThe number or address to send from. It must belong to your workspace.
curl -X GET "https://api.sautidesk.com/v1/desk/contacts/string/whatsapp/window"