Apagar chat inteiro

DELETE

api

chat

deleteChat

:instance

Apagar chat inteiro

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 ou TokenInstance • Rate-limit: Global (100/min) • Idempotente: sim Remove um chat (conversa) da sua lista no WhatsApp. Opcionalmente apaga também os arquivos de mídia salvos localmente.

Operação local apenas. Outros participantes (em grupos) ou o destinatário (em DMs) continuam vendo o histórico do lado deles. Para sair de um grupo, use DELETE /api/group/leave.

Exemplos

Manter mídia local

Remove o chat da lista do WhatsApp mas preserva os arquivos de mídia armazenados localmente (S3/disco). Útil quando você ainda quer manter os anexos para auditoria ou reprocessamento.

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

Apagar mídia também

Com deleteMedia: true, além de remover o chat o servidor também apaga os arquivos de mídia salvos localmente para essa conversa. Operação irreversível do lado da 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)
}

Resposta de sucesso

200 OK

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

A message muda conforme deleteMedia:

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

Path parameters

string

obrigatório

Nome da instância.

Headers

string

obrigatório

TokenAccount ou TokenInstance.

Request body

string

obrigatório

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

boolean

padrão:"false"

Se true, também remove os arquivos de mídia armazenados localmente para esse chat.

Notas

O chat some da sua lista em todos os dispositivos vinculados (sincroniza via AppState).
Em grupos, apagar o chat não sai do grupo, o link com o grupo permanece.
O WhatsApp do celular tem storage independente; o deleteMedia aqui afeta apenas as mídias salvas pela RyzeAPI no S3/disco.

Respostas de erro

HTTP	`error.message`	Quando
400	`Invalid request body`	JSON malformado.
400	`Number is required`	Campo ausente.
401	`Invalid token`	,
404	`Instance not found`	,
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 chat inteiro

Exemplos

Manter mídia local

Apagar mídia também

Resposta de sucesso

Path parameters

Headers

Request body

Notas

Respostas de erro

​Exemplos

​Manter mídia local

​Apagar mídia também

​Resposta de sucesso

​Path parameters

​Headers

​Request body

​Notas

​Respostas de erro

Exemplos

Manter mídia local

Apagar mídia também

Resposta de sucesso

Path parameters

Headers

Request body

Notas

Respostas de erro