Eliminar mensaje

DELETE

api

chat

delete

:instance

Eliminar mensaje

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 o TokenInstance • Rate-limit: Global (100/min) • Idempotente: parcialmente Elimina un mensaje específico en dos modos:

Para todos (deleteForEveryone: true), revoca en WhatsApp; aparece “Este mensaje fue eliminado” para todos. delete_type: "revoke".
Solo para mí (deleteForEveryone: false, predeterminado), elimina únicamente de manera local en tus dispositivos. Los destinatarios siguen viéndolo. delete_type: "delete_for_me".

La ventana de revocación (“para todos”) tiene un límite de WhatsApp: alrededor de 2 días y 12 horas después del envío. La API siempre acepta la solicitud (envía el REVOKE) y devuelve éxito, pero el cliente del destinatario ignora la revocación de mensajes más antiguos que esa ventana — es decir, el éxito en la API no garantiza la eliminación en la pantalla del destinatario.

Ejemplos

Para todos (revocar)

Revoca el mensaje en WhatsApp con deleteForEveryone: true. Reemplaza el contenido con “Este mensaje fue eliminado” para cada participante de la conversación, sujeto a la ventana de alrededor de 2 días y 12 horas tras el envío.

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

Solo para mí

Con deleteForEveryone: false, el mensaje desaparece solo de tus dispositivos vinculados (sincronizado vía AppState). El destinatario sigue viendo el contenido 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)
}

Respuesta exitosa

Revocar
Eliminar para mí

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
}

Parámetros de ruta

string

requerido

Nombre de la instancia.

Cabeceras

string

requerido

TokenAccount o TokenInstance.

Cuerpo de la solicitud

string

requerido

ID del mensaje a eliminar.

boolean

predeterminado:"false"

true revoca para todos (delete_type: "revoke"); false elimina solo localmente (delete_type: "delete_for_me").

Notas

Revocar dispara un evento message.exchange con type: "message_revoke" en el webhook/WebSocket.
Eliminar para mí sincroniza vía AppState con tus otros dispositivos vinculados, pero no notifica al destinatario.
Si la operación se repite sobre un mensaje ya revocado, WhatsApp devuelve un error.

Respuestas de error

HTTP	`error.message`	Cuándo
400	`Invalid request body`	JSON malformado.
400	`MessageID is required`	Campo faltante.
401	`Invalid token`	Token faltante/inválido.
404	`Instance not found`	La instancia no existe.
404	`message not found`	El `messageId` no está en la base de datos.
503	`Instance is not connected to WhatsApp`	Sin sesión activa.

Introducción

Instancia

Eventos

Mensajes

Llamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidad

Eliminar mensaje

Ejemplos

Para todos (revocar)

Solo para mí

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Respuestas de error

​Ejemplos

​Para todos (revocar)

​Solo para mí

​Respuesta exitosa

​Parámetros de ruta

​Cabeceras

​Cuerpo de la solicitud

​Notas

​Respuestas de error

Ejemplos

Para todos (revocar)

Solo para mí

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Respuestas de error