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": "[email protected]",
  "messageIds": [
    "[email protected]_AAAAAAAAAAAAAAAAAAAA"
  ],
  "participant": "[email protected]",
  "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": "[email protected]",
  "messageIds": [
    "3EB0XXXXXX"
  ]
}

Body Parameters

PropertyTypeRequiredDescription
sessionIdstring✅ YesAuthenticated session ID that will mark the messages
jidstring✅ YesChat identifier (WhatsApp JID). Format: [email protected] for contacts or [email protected] 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": "[email protected]",
    "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
session
string
required

Session name (instanceName)

Example:

"my-session"

messageIds
string[]
Example:
[
"[email protected]_AAAAAAAAAAAAAAAAAAAA"
]
participant
string

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

Response

201 - application/json

The response is of type object.