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

const options = {
  method: 'DELETE',
  headers: {token: '<token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({messageId: '<string>', deleteForEveryone: true})
};

fetch('https://api.example.com/api/chat/delete/:instance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/api/chat/delete/:instance"

payload = {
    "messageId": "<string>",
    "deleteForEveryone": True
}
headers = {
    "token": "<token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

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

await fetch(`https://ryzeapi.cloud/api/chat/delete/${process.env.Instance_Name}`, {
  method: "DELETE",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    messageId:         "3EB08FCF27E532F1B0F5",
    deleteForEveryone: true
  })
});

import os, requests

requests.delete(
    f"https://ryzeapi.cloud/api/chat/delete/{os.environ['Instance_Name']}",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "messageId":         "3EB08FCF27E532F1B0F5",
        "deleteForEveryone": True
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "messageId": "3EB08FCF27E532F1B0F5",
        "deleteForEveryone": true
    }`)
    req, _ := http.NewRequest("DELETE", "https://ryzeapi.cloud/api/chat/delete/"+os.Getenv("Instance_Name"), body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

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

await fetch(`https://ryzeapi.cloud/api/chat/delete/${process.env.Instance_Name}`, {
  method: "DELETE",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    messageId:         "3EB08FCF27E532F1B0F5",
    deleteForEveryone: false
  })
});

import os, requests

requests.delete(
    f"https://ryzeapi.cloud/api/chat/delete/{os.environ['Instance_Name']}",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "messageId":         "3EB08FCF27E532F1B0F5",
        "deleteForEveryone": False
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "messageId": "3EB08FCF27E532F1B0F5",
        "deleteForEveryone": false
    }`)
    req, _ := http.NewRequest("DELETE", "https://ryzeapi.cloud/api/chat/delete/"+os.Getenv("Instance_Name"), body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

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

string

obrigatório

Nome da instância.

Headers

string

obrigatório

TokenAccount ou TokenInstance.

Request body

string

obrigatório

ID da mensagem a apagar.

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.

Introdução

Instância

Eventos

Mensagens

Chamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidade

Apagar mensagem

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

Exemplos

Para todos (revoke)

Só pra mim

Resposta de sucesso

Path parameters

Headers

Request body

Notas

Respostas de erro