Apagar mensagem

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
}
'

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: cerca de 2 dias e 12 horas após o envio. A API sempre aceita o pedido (envia o REVOKE) e retorna sucesso, mas o cliente do destinatário ignora a revogação de mensagens mais antigas que essa janela — ou seja, sucesso na API não garante a remoção na tela do destinatário.

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 cerca de 2 dias e 12 horas 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

Revoke
Delete for me

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
}

200 OK

{
  "success": true,
  "message": "Message deleted for me successfully",
  "message_id": "3EB08FCF27E532F1B0F5",
  "chat_jid": "5511999999999@s.whatsapp.net",
  "delete_type": "delete_for_me",
  "deleted_for_everyone": false
}

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

HTTP	`error.message`	Quando
400	`Invalid request body`	JSON malformado.
400	`MessageID is required`	Campo ausente.
401	`Invalid token`	Token ausente/inválido.
404	`Instance not found`	Instância inexistente.
404	`message not found`	`messageId` não está no banco.
503	`Instance is not connected to WhatsApp`	Sem sessão ativa.

Status de entrega da mensagem

Mídia em base64

​Exemplos

​Para todos (revoke)

​Só pra mim

​Resposta de sucesso

​Path parameters

​Headers

​Request body

​Notas

​Respostas de erro

Exemplos

Para todos (revoke)

Só pra mim

Resposta de sucesso

Path parameters

Headers

Request body

Notas

Respostas de erro