Send an "agent is typing" indicator

curl --request POST \
  --url https://app.livechatai.com/api/v2/conversations/{conversationId}/typing \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "isTyping": true,
  "userId": "user_1234567890"
}
'

{
  "status": "success"
}

Conversations

Send an "agent is typing" indicator

Broadcast an ephemeral “agent is typing” indicator to the live chat widget for a specific conversation. Use this to show a typing animation in the messenger while your agent composes a reply in your own interface. The signal is not persisted: send it with isTyping=true while the agent is typing and isTyping=false when they stop or send a message. To avoid noise, send true at most once every ~5 seconds. The indicator is hidden automatically after 10 seconds without a fresh signal, so a missed false is self-healing. userId is optional — omit it to attribute the typing to the workspace owner.

POST

api

conversations

{conversationId}

typing

Send an "agent is typing" indicator

curl --request POST \
  --url https://app.livechatai.com/api/v2/conversations/{conversationId}/typing \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "isTyping": true,
  "userId": "user_1234567890"
}
'

{
  "status": "success"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

conversationId

string

required

Unique identifier of the conversation

Example:

"chat_1234567890"

Body

application/json

Typing signal details

isTyping

boolean

required

true while composing, false when the agent stops typing

Example:

true

userId

string

ID of the agent who is typing. Optional — defaults to the workspace owner when omitted.

Example:

"user_1234567890"

Response

Typing signal broadcast successfully

status

string

Example:

"success"

Reply to a conversation End a conversation