Skip to main content
POST
Mark Conversation Status
Marks a subscriber’s conversation with one of six statuses — mirrors the same actions available manually from the Shared Inbox conversation menu.

The action_status encoding

Other endpoints that return a conversation’s status (e.g. fetching a subscriber’s chat) encode it numerically as action_status:
Where to find phone_number_id: open Chatbot Manager, select your bot, and the phone number is shown at the top. See Finding Your IDs & API Token for a screenshot.

Body

application/x-www-form-urlencoded
apiToken
string
required

Your ChatSyncs API key (not a WhatsApp/Meta access token). Where to find it.

Example:

"API-KEY"

phone_number_id
string
required

The WhatsApp account's phone number ID. Where to find it.

Example:

"PHONE-NUMBER-ID"

phone_number
string
required

The subscriber's phone number, with country code, digits only.

Example:

"PHONE-NUMBER"

action
enum<string>
required

The status to set on this subscriber conversation.

Available options:
resolved,
reopen,
archived,
unarchived,
blocked,
unblocked
Example:

"resolved"

Response

200 - application/json

Standard ChatSyncs response. status is "1" on success and "0" on failure.

status
string

"1" = success, "0" = failure.

message
string

Human-readable result message.