Pular para o conteúdo principal
DELETE
/
api
/
chat
/
delete
/
:instance
Apagar mensagem
curl --request DELETE \
  --url https://api.example.com/api/chat/delete/:instance \
  --header 'Content-Type: application/json' \
  --header 'token: <token>' \
  --data '
{
  "messageId": "<string>",
  "deleteForEveryone": true
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.ryzeapi.cloud/llms.txt

Use this file to discover all available pages before exploring further.

Auth: TokenAccount ou TokenInstance • Rate-limit: Global (100/min) • Idempotente: parcialmente Apaga uma mensagem específica em duas modalidades:
  • Para todos (deleteForEveryone: true), revoga no WhatsApp; aparece “Esta mensagem foi apagada” para todos. delete_type: "revoke".
  • Só pra mim (deleteForEveryone: false, padrão), apaga apenas localmente nos seus dispositivos. Destinatários continuam vendo. delete_type: "delete_for_me".
A janela de revogação (“para todos”) tem limite do WhatsApp, geralmente até 15 minutos após o envio. Mensagens mais antigas falham.

​
Exemplos

​
Para todos (revoke)

Revoga a mensagem no WhatsApp com deleteForEveryone: true. Substitui o conteúdo por “Esta mensagem foi apagada” para todos os participantes da conversa, sujeito à janela de até 15 minutos após o envio. 
curl -X DELETE "https://ryzeapi.cloud/api/chat/delete/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "messageId": "3EB08FCF27E532F1B0F5",
    "deleteForEveryone": true
  }'

​
Só pra mim

Com deleteForEveryone: false, a mensagem some apenas dos seus dispositivos vinculados (sincroniza via AppState). O destinatário continua vendo o conteúdo original normalmente. 
curl -X DELETE "https://ryzeapi.cloud/api/chat/delete/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "messageId": "3EB08FCF27E532F1B0F5",
    "deleteForEveryone": false
  }'

​
Resposta de sucesso

200 OK
{
  "success": true,
  "message": "Message deleted for everyone successfully",
  "message_id": "3EB08FCF27E532F1B0F5",
  "chat_jid": "5511999999999@s.whatsapp.net",
  "delete_type": "revoke",
  "deleted_for_everyone": true
}

​
Path parameters

​
instance
string
obrigatório
Nome da instância.

​
Headers

​
token
string
obrigatório
TokenAccount ou TokenInstance.

​
Request body

​
messageId
string
obrigatório
ID da mensagem a apagar.
​
deleteForEveryone
boolean
padrão:"false"
true revoga para todos (delete_type: "revoke"); false apaga apenas localmente (delete_type: "delete_for_me").

​
Notas

  • Revoke dispara evento message.exchange com type: "message_revoke" no webhook/WebSocket.
  • Delete for me sincroniza via AppState com seus outros dispositivos vinculados, mas não notifica o destinatário.
  • Se a operação for repetida em uma mensagem já revogada, o WhatsApp retorna erro.

​
Respostas de erro

HTTPerror.messageQuando
400Invalid request bodyJSON malformado.
400MessageID is requiredCampo ausente.
401Invalid tokenToken ausente/inválido.
404Instance not foundInstância inexistente.
404message not foundmessageId não está no banco.
503Instance is not connected to WhatsAppSem sessão ativa.