Mark as Seen

Mark messages as seen (read)

POST /api/sendSeen

cURL

cURL

curl --request POST \
  --url https://{host}/api/sendSeen \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "chatId": "[e-mail]",
  "session": "my-session",
  "messageIds": [
    "[e-mail]_AAAAAAAAAAAAAAAAAAAA"
  ],
  "participant": "[e-mail]"
}
'

Success Response

{
  "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": "[e-mail]",
  "messageIds": [
    "3EB0XXXXXX"
  ]
}

Body Parameters

Property	Type	Required	Description
sessionId	string	✅ Yes	Authenticated session ID that will mark the messages
jid	string	✅ Yes	Chat identifier (WhatsApp JID). Format: [e-mail] for contacts or [e-mail] for groups
messageIds	array	✅ Yes	Array of message IDs to be marked as seen

Success Response

{
  "success": true
}

Status Codes

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

Usage Example

cURL

curl -X POST https://api.wappfy.com.br/api/sendSeen \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "my-session",
    "jid": "[e-mail]",
    "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:

"[e-mail]"

session · string · required

Session name (instanceName)

Example:

"my-session"

messageIds · string[]

Example:

[
  "[e-mail]_AAAAAAAAAAAAAAAAAAAA"
]

participant · string

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

Example:

"[e-mail]"

Response

201 - application/json

The response is of type object.