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. action is case-sensitive — resolved, reopen, archived, unarchived, blocked or unblocked; Resolved is rejected with The selected action is invalid. Each change also adds a system note to the conversation, for example Conversation was Reopened by ….

The action_status encoding

ChatSyncs stores a conversation’s status as a number, called action_status. None of the endpoints in this reference returns it, but you may see it in the dashboard or an export:
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

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

status
string

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

message
string

Human-readable result message.