Eliminar chat completo

DELETE

api

chat

deleteChat

:instance

Eliminar chat completo

curl --request DELETE \
  --url https://api.example.com/api/chat/deleteChat/:instance \
  --header 'Content-Type: application/json' \
  --header 'token: <token>' \
  --data '
{
  "number": "<string>",
  "deleteMedia": true
}
'

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

fetch('https://api.example.com/api/chat/deleteChat/: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/deleteChat/:instance"

payload = {
    "number": "<string>",
    "deleteMedia": 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: sí Elimina un chat (conversación) de tu lista de WhatsApp. Opcionalmente también borra los archivos multimedia almacenados localmente.

Operación local únicamente. Los demás participantes (en grupos) o el destinatario (en DMs) seguirán viendo el historial de su lado. Para salir de un grupo, usa DELETE /api/group/leave.

Ejemplos

Mantener media local

Elimina el chat de la lista de WhatsApp pero preserva los archivos multimedia almacenados localmente (S3/disco). Útil cuando aún quieres conservar adjuntos para auditoría o reprocesamiento.

curl -X DELETE "https://ryzeapi.cloud/api/chat/deleteChat/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{"number": "5511999999999"}'

await fetch(`https://ryzeapi.cloud/api/chat/deleteChat/${process.env.Instance_Name}`, {
  method: "DELETE",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ number: "5511999999999" })
});

import os, requests

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

package main

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

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

Borrar también la media

Con deleteMedia: true, además de eliminar el chat el servidor borra los archivos multimedia almacenados localmente para esa conversación. Irreversible del lado de RyzeAPI.

curl -X DELETE "https://ryzeapi.cloud/api/chat/deleteChat/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5511999999999",
    "deleteMedia": true
  }'

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

import os, requests

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

package main

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

func main() {
    body := strings.NewReader(`{
        "number": "5511999999999",
        "deleteMedia": true
    }`)
    req, _ := http.NewRequest("DELETE", "https://ryzeapi.cloud/api/chat/deleteChat/"+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

200 OK

{
  "success": true,
  "message": "Chat deleted successfully (including media)",
  "chat_jid": "5511999999999@s.whatsapp.net",
  "delete_media": true
}

El message cambia según deleteMedia:

false → "Chat deleted successfully"
true → "Chat deleted successfully (including media)"

Parámetros de ruta

string

requerido

Nombre de la instancia.

Cabeceras

string

requerido

TokenAccount o TokenInstance.

Cuerpo de la solicitud

string

requerido

Número (5511999999999) o JID (5511999999999@s.whatsapp.net, ...@lid, 120363...@g.us) del chat.

boolean

predeterminado:"false"

Si es true, también elimina los archivos multimedia almacenados localmente para este chat.

Notas

El chat desaparece de tu lista en cada dispositivo vinculado (sincronizado vía AppState).
En grupos, eliminar el chat no te saca del grupo, el vínculo con el grupo permanece.
WhatsApp del teléfono tiene almacenamiento independiente; deleteMedia aquí solo afecta los archivos multimedia guardados por RyzeAPI en S3/disco.

Respuestas de error

HTTP	`error.message`	Cuándo
400	`Invalid request body`	JSON malformado.
400	`Number is required`	Campo faltante.
401	`Invalid token`	,
404	`Instance not found`	,
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 chat completo

Ejemplos

Mantener media local

Borrar también la media

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Respuestas de error

​Ejemplos

​Mantener media local

​Borrar también la media

​Respuesta exitosa

​Parámetros de ruta

​Cabeceras

​Cuerpo de la solicitud

​Notas

​Respuestas de error

Ejemplos

Mantener media local

Borrar también la media

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Respuestas de error