Assign, close or reopen a chat

action is assign, close or reopen — the app’s Inbox rules. assign needs member_id (an id from GET /v1/team). close marks the chat Done; the customer writing again reopens it, or reopen does.

Permission: A Full key.

POST /v1/chats/{customer}/{action}

Assign, close or reopen a chat

cURL

curl --request POST \
  --url https://api.getreply.in/v1/chats/{customer}/{action} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "member_id": "cm8a1b2c3d4e5f60718293a4b"
}
'

200

Example

{
  "customer": {
    "phone": "<string>",
    "user_id": "<string>",
    "username": "<string>"
  },
  "status": "open",
  "assignee": {
    "id": "<string>",
    "name": "<string>"
  },
  "last_message_at": "<string>"
}

Authorizations

Authorization · string · header · required

Your API key, e.g. gr_live_…

Headers

Idempotency-Key · string · required

Your own unique id for this request (at most 255 characters). The same id and body within 24 hours answers the first answer again — never a second send or charge.

Maximum string length: 255

Path Parameters

customer · string · required

The number with its country code, e.g. +9198250*****, or the WhatsApp username id.

action · string · required

The action.

Body

application/json

member_id · string

Only for assign: the team member's id.

Response

200

application/json

The chat.

customer · object

Who the customer is. phone can be null: a customer who uses a WhatsApp username may not share their number. user_id is WhatsApp's business-scoped user ID (for example "IN.13491208655302741918").

Show child attributes

status · enum<string>

Available options: open, closed

assignee · object | null

Show child attributes

last_message_at · string | null