Skip to main content
Use typing indicators as a UI signal before an agent or automation sends a follow-up. They are best-effort and should not be treated as delivery confirmation. POST /api/v1/chats/{id}/typing

​
Request

curl -X POST https://console.trychert.com/api/v1/chats/$CHAT_ID/typing \
  -H "Authorization: Bearer $CHERT_SIGNING_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "state": "typing" }'
Use "stopped" to clear the indicator: 
curl -X POST https://console.trychert.com/api/v1/chats/$CHAT_ID/typing \
  -H "Authorization: Bearer $CHERT_SIGNING_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "state": "stopped" }'

​
Fields

FieldRequiredNotes
stateYestyping or stopped.

​
Response

{
  "status": "sent",
  "chat_id": "0f2d3c1a-8b4e-4f6a-90d2-1a3b4c5d6e7f",
  "state": "typing"
}

​
Notes

BehaviorWhat it means
Existing chats onlyCreate or receive a chat first, then send typing indicators.
Pinned line requiredChert sends the signal from the line already attached to the chat.
Best-effortRecipients may not always see typing dots, depending on device state and network conditions.

​
See also