Skip to main content
POST
/
api
/
{session}
/
status
/
delete
{
  "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E",
  "sender": "5511999999999@s.whatsapp.net",
  "participants": [
    "5511888888888@s.whatsapp.net",
    "5511777777777@s.whatsapp.net"
  ]
}
{
    "success": true,
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}

Descrição

Este endpoint permite deletar um status (story) que foi previamente enviado no WhatsApp. Você pode deletar o status para todos os contatos ou apenas para contatos específicos.

Parâmetros de URL

session
string
required
ID único da sessão autenticada

Corpo da Requisição

messageId
string
required
ID da mensagem de status a ser deletada
sender
string
required
JID do remetente (sua conta) no formato 5511999999999@s.whatsapp.net
participants
array
Array de JIDs dos contatos para os quais o status será deletado. Se não informado, o status será deletado para todos os contatos.Formato do JID: ["5511999999999@s.whatsapp.net"]
{
  "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E",
  "sender": "5511999999999@s.whatsapp.net",
  "participants": [
    "5511888888888@s.whatsapp.net",
    "5511777777777@s.whatsapp.net"
  ]
}

Resposta

success
boolean
required
Indica se o status foi deletado com sucesso
messageId
string
ID da mensagem de status que foi deletada
{
    "success": true,
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}

Códigos de Status

  • 200 - Status deletado com sucesso
  • 400 - Parâmetros inválidos
  • 401 - Não autorizado
  • 404 - Status não encontrado
  • 500 - Erro no servidor

Exemplo de Uso

curl -X POST https://api.wappfy.com.br/api/my-session/status/delete \
  -H "Content-Type: application/json" \
  -d '{
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E",
    "sender": "5511999999999@s.whatsapp.net"
  }'

Notas

  • Status são conteúdos temporários (Stories) que desaparecem após 24 horas
  • Você só pode deletar status que foram enviados pela sua conta
  • Se o parâmetro participants não for informado, o status será deletado para todos os contatos
  • O campo sender deve conter o JID da sua própria conta no formato 5511999999999@s.whatsapp.net
  • Uma vez deletado, o status não poderá ser recuperado
  • O messageId pode ser obtido na resposta do endpoint de envio de status

Authorizations

apikey
string
header
required

Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)

Path Parameters

session
string
required

Nome da sessão (instanceName)

Body

application/json
id
string

Status message id to delete

Example:

"AAAAAAAAAAAAAAAAA"

contacts
string[]

Contact list to send the status to.

Example:

null

I