Skip to main content
POST
/
api
/
sendSeen
cURL
curl --request POST \
  --url https://{host}/api/sendSeen \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '{
  "chatId": "5511999999999@c.us",
  "messageIds": [
    "false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA"
  ],
  "participant": "5511999999999@c.us",
  "session": "my-session"
}'
{
  "success": true
}

​
Description

This endpoint allows marking one or more messages as seen (read), sending read confirmations (blue checkmarks) to the sender. Useful for automations that need to confirm the reading of received messages.

​
Body

{
  "sessionId": "my-session",
  "jid": "5511999999999@s.whatsapp.net",
  "messageIds": [
    "3EB0XXXXXX"
  ]
}

​
Body Parameters

PropertyTypeRequiredDescription
sessionIdstring✅ YesAuthenticated session ID that will mark the messages
jidstring✅ YesChat identifier (WhatsApp JID). Format: 5511999999999@s.whatsapp.net for contacts or 120363XXXXX@g.us for groups
messageIdsarray✅ YesArray of message IDs to be marked as seen
{
  "success": true
}

​
Status Codes

  • 200 - Mensagens marcadas como vistas com sucesso
  • 400 - Invalid parameters
  • 401 - Unauthorized session
  • 404 - Session not found

​
Usage Example

curl -X POST https://api.wappfy.com.br/api/sendSeen \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "my-session",
    "jid": "5511999999999@s.whatsapp.net",
    "messageIds": ["3EB0XXXXXX", "3EB0YYYYYY"]
  }'

Authorizations

​
apikey
string
header
required

Your Wappfy API key (get it at dash.wappfy.com.br)

Body

application/json
​
chatId
string
required
Example:

"5511999999999@c.us"

​
session
string
required

Session name (instanceName)

Example:

"my-session"

​
messageIds
string[]
Example:
[
  "false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA"
]
​
participant
string

NOWEB engine only - the ID of the user that sent the message

Example:

"5511999999999@c.us"

Response

201 - application/json

The response is of type object.

⌘I