Sender Actions

The sender actions message property allows you to control indicators for typing and read receipts in the conversation via the Send API. This is helpful for letting message recipients known you have seen and are processing their message.


Displaying a Sender Action

To display a sender action in the conversation, send a POST request to the Messenger Platform with the sender_action property:

curl -X POST -H "Content-Type: application/json" -d '{

Note that the request should only include sender_action and the recipient object. All other Send API properties, such as text and templates, should be sent in a separate request.

For a complete list of API calls and request properties, see the Send API Reference.

Supported Sender Actions

The following sender actions are supported. Typing indicators are automatically turned off after 20 seconds

Sender Action Description


Mark last message as read


Turn typing indicators on


Turn typing indicators off