Show typing indicator to a recipient

View as Markdown

Queues a typing bubble on the recipient’s device via an account-owned Mac agent. Uses explicit from (must be owned by the account), else the existing to→from mapping, else any online agent owned by the account.

Authentication

X-App-Idstring

Your MessageBlue App ID, sent in clear on every request. It is paired with request signing: each request is also signed with your App Secret (see the Authentication tag). The App Secret itself is NEVER transmitted — it is only the HMAC signing key.

Request

This endpoint expects an object.
tostringRequired
fromstringOptional

Optional agent number. If omitted, it is resolved from the existing mapping for to.

typingDurationintegerOptional1-20Defaults to 5

Typing bubble duration in seconds (capped at 20).

Response

Typing indicator queued
okboolean
dataobject

Endpoint-specific payload wrapped in a standard success envelope.

metaobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error
503
Service Unavailable Error