Skip to main content
These endpoints operate on messages that already exist.

​
Message operations

EndpointBodyUse
POST /message/reactPhone, Body, Id, IsFromMe, ParticipantReact to a message. Use Body: "remove" or empty body to remove a reaction.
POST /message/editChat, Message, MessageIDEdit a sent text message.
POST /message/deleteChat, MessageIDRevoke a message for everyone.
POST /message/markreadId, Chat, SenderMark one or more message IDs as read.
POST /message/statusIdRead stored local status for a message ID from WaGo’s database.
POST /message/presencePhone, State, MediaSend chat presence through the message presence controller.

​
React example

{
  "Phone": "15551234567",
  "Body": "👍",
  "Id": "MESSAGE_ID",
  "IsFromMe": false,
  "Participant": "[email protected]"
}
For one-to-one chats, Participant can be the same user JID. For group messages, use the participant JID from the webhook.

​
Download media

Download endpoints reconstruct encrypted WhatsApp media from metadata in the message webhook.
EndpointMedia
POST /message/download/imageImage
POST /message/download/videoVideo
POST /message/download/documentDocument
POST /message/download/audioAudio
POST /message/download/stickerSticker
POST /message/downloadimageLegacy image alias
Body fields come from the webhook media message: 
{
  "url": "https://mmg.whatsapp.net/...",
  "directPath": "/v/t62.7118-24/...",
  "mediaKey": "base64-media-key",
  "mimetype": "image/jpeg",
  "fileEncSHA256": "base64-hash",
  "fileSHA256": "base64-hash",
  "fileLength": 12345
}
WaGo stores downloaded files under its local files directory for the token. Clean up files according to your product retention policy.