Sender Actions

Updated: Jun 26, 2026

This guide explains how to display sender actions in a conversation so that message recipients know you have seen and are processing their message.

Display a sender action

Typing indicator

To display the typing_on or typing_off action for a sender in the conversation, send a POST request to the /PAGE-ID/messages endpoint with the sender_action parameter set to typing_on or typing_off.

For the best conversational experience, send the typing_on indicator when your bot receives a message it will respond to. Do not allow an unnatural amount of time (too long or too short) to pass between typing_on and typing_off sender actions. Ideally, the user should feel that a real person was typing the message in the elapsed time.

curl -X POST -H "Content-Type: application/json" -d '{  
  "recipient":{  
    "id":"<IGSID>"  
  },  
  "sender_action":"typing_on"  
}' "https://graph.facebook.com/VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS_TOKEN"

Mark messages as seen

To send the mark_seen indicator to the most recent message, send a POST request to the /PAGE-ID/messages endpoint with the sender_action parameter set to mark_seen.

For the best conversational experience, send the mark_seen indicator when your bot receives a message so that the user does not feel ignored.

curl -X POST -H "Content-Type: application/json" -d '{  
  "recipient":{  
    "id":"<IGSID>"  
  },  
  "sender_action":"mark_seen"  
}' "https://graph.facebook.com/VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS_TOKEN"

Limitations

• Requests to display sender actions for typing indicators and mark_seen indicators should only include the sender_action parameter and the recipient object. All other Send API properties, such as text and templates, should be sent in a separate request.
• The recipient must be signed in for sender actions to be displayed.

Developer Support

• Use the Meta Status tool⁠ to check for the status and outages of Meta business products.
• Use the Meta Developer Support tool to report bugs and view reported bugs, get help with Ads or Business Manager, and more.