Saltar al contenido principal
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
}
'
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
  }'

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

​
Respuesta exitosa

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
}

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Cabeceras

​
token
string
requerido
TokenAccount o TokenInstance.

​
Cuerpo de la solicitud

​
messageId
string
requerido
ID del mensaje a eliminar.
​
deleteForEveryone
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

HTTPerror.messageCuándo
400Invalid request bodyJSON malformado.
400MessageID is requiredCampo faltante.
401Invalid tokenToken faltante/inválido.
404Instance not foundLa instancia no existe.
404message not foundEl messageId no está en la base de datos.
503Instance is not connected to WhatsAppSin sesión activa.