Skip to content

Send typing indicator

Show a typing indicator in a conversation. Platform support:

  • Facebook Messenger: Shows "Page is typing..." for 20 seconds
  • Telegram: Shows "Bot is typing..." for 5 seconds
  • WhatsApp: Shows "typing..." for up to 25 seconds. Requires a recent inbound message in the conversation (Meta references the inbound message id) and also marks that message as read as a side-effect.
  • All others: Returns 200 but no-op (platform doesn't support it)

Typing indicators are best-effort. The endpoint always returns 200 even if the platform call fails.

POST /v1/inbox/conversations/{conversationId}/typing

Show a typing indicator in a conversation. Platform support:

  • Facebook Messenger: Shows "Page is typing..." for 20 seconds
  • Telegram: Shows "Bot is typing..." for 5 seconds
  • WhatsApp: Shows "typing..." for up to 25 seconds. Requires a recent inbound message in the conversation (Meta references the inbound message id) and also marks that message as read as a side-effect.
  • All others: Returns 200 but no-op (platform doesn't support it)

Typing indicators are best-effort. The endpoint always returns 200 even if the platform call fails.

Parameters

  • conversationId (path, string) required — The conversation ID

Request body

Content-Type: application/json

  • accountId (string) required — Social account ID

Responses

200 — Typing indicator sent (or no-op on unsupported platforms)

  • success (boolean)

401

403 — Inbox addon required

404 — Account or conversation not found