Skip to content

Send messages

Mark as read

Mark a received message as read with POST /v1/messages/{id}/read and optionally show the typing indicator.

POST /v1/messages/{id}/read marks a message the contact sent as read. With typing: true, it also shows the typing indicator.

  • An API key with the send permission.
  • The id (msg_…) of the received message, which comes in the message.received event.
Janela do terminal
curl -X POST https://api.messajo.com/v1/messages/msg_.../read \
-H "Authorization: Bearer $MESSAJO_API_KEY"

With the typing indicator:

Janela do terminal
curl -X POST https://api.messajo.com/v1/messages/msg_.../read \
-H "Authorization: Bearer $MESSAJO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "typing": true }'

The response returns the id and the confirmation:

{ "id": "msg_...", "read": true }
Field Description
id (path) msg_… id of the received message.
typing (body, optional) true shows the typing indicator. Default false.
  • WhatsApp: the typing indicator always marks the message as read.
  • Instagram: typing: true shows the typing indicator before sending and POST /v1/messages/{id}/read marks the conversation as seen.
  • Messenger: uses the same engine as Instagram, see Messages.

typing spends one token from the number’s bucket (see Limits).