> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wappfy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Deletar Status Enviado
> Deletar um status (story) previamente enviado no WhatsApp
## 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
ID único da sessão autenticada
## Corpo da Requisição
ID da mensagem de status a ser deletada
JID do remetente (sua conta) no formato `5511999999999@s.whatsapp.net`
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"]`
```json Deletar para Contatos Específicos theme={null}
{
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E",
"sender": "5511999999999@s.whatsapp.net",
"participants": [
"5511888888888@s.whatsapp.net",
"5511777777777@s.whatsapp.net"
]
}
```
```json Deletar para Todos os Contatos theme={null}
{
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E",
"sender": "5511999999999@s.whatsapp.net"
}
```
## Resposta
Indica se o status foi deletado com sucesso
ID da mensagem de status que foi deletada
```json Resposta de Sucesso theme={null}
{
"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
```bash cURL theme={null}
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"
}'
```
```javascript JavaScript theme={null}
const session = 'my-session';
const response = await fetch(`https://api.wappfy.com.br/api/${session}/status/delete`, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
messageId: '3EB0796F91D8B2A4E053AC100F0A4D1E',
sender: '5511999999999@s.whatsapp.net',
participants: ['5511888888888@s.whatsapp.net']
})
});
const data = await response.json();
console.log(data);
```
```python Python theme={null}
import requests
session = 'my-session'
payload = {
'messageId': '3EB0796F91D8B2A4E053AC100F0A4D1E',
'sender': '5511999999999@s.whatsapp.net',
'participants': ['5511888888888@s.whatsapp.net']
}
response = requests.post(
f'https://api.wappfy.com.br/api/{session}/status/delete',
json=payload
)
data = response.json()
print(data)
```
## 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
## OpenAPI
````yaml viewer.json post /api/{session}/status/delete
openapi: 3.1.0
info:
title: Wappfy - WhatsApp HTTP API
version: '2.0'
contact: {}
servers:
- url: https://{host}
description: Servidor Customizável
variables:
host:
default: api.wappfy.com.br
description: 'URL do servidor (ex: api.wappfy.com.br ou seu-servidor.com)'
security:
- api_key: []
tags:
- name: 🖥️ Sessions
description: >-
Controlar sessões do WhatsApp (contas) (Control WhatsApp sessions
(accounts))
- name: 🔑 Auth
description: Autenticação
- name: 🆔 Profile
description: Informações do seu perfil
- name: 🖼️ Screenshot
description: Obter captura de tela do WhatsApp e mostrar código QR
- name: 📤 Chatting
description: Métodos de conversação
- name: 📢 Channels
description: Métodos de canais (newsletters) (Channels (newsletters) methods)
- name: 🟢 Status
description: Métodos de status (aka stories) (Status (aka stories) methods)
- name: 💬 Chats
description: Métodos de conversas
- name: 👤 Contacts
description: >-
Métodos de contatos. Use número de telefone (sem +) ou número de telefone
e `@c.us` no final como `contactId`. Ex: `12312312310` OU
`12312312310@c.us` (Contacts methods.
Use phone number (without +) or phone number and `@c.us` at the end as `contactId`.
'E.g: `12312312310` OR `12312312310@c.us`
)
- name: 👥 Groups
description: Métodos de grupos (Groups methods).
- name: ✅ Presence
description: Informações de presença
- name: 📅 Events
description: Mensagem de Evento
- name: 🏷️ Labels
description: Etiquetas - disponível apenas para contas WhatsApp Business
- name: 🔍 Observability
description: Outros métodos
- name: 🗄️ Storage
description: Métodos de armazenamento
externalDocs:
description: Wappfy - WhatsApp HTTP API
url: https://wappfy.com.br/
paths:
/api/{session}/status/delete:
post:
tags:
- 🟢 Status
summary: EXCLUIR status enviado
description: O parâmetro {session} deve ser o instanceName da sessão.
operationId: StatusController_deleteStatus
parameters:
- name: session
required: true
in: path
description: Nome da sessão (instanceName)
example: my-session
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteStatusRequest'
responses:
'201':
description: ''
security:
- api_key: []
components:
schemas:
DeleteStatusRequest:
type: object
properties:
id:
type: string
description: Status message id to delete
example: AAAAAAAAAAAAAAAAA
default: null
contacts:
description: Contact list to send the status to.
example: null
type: array
items:
type: string
securitySchemes:
api_key:
type: apiKey
in: header
name: apikey
description: Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)
````