{
"video": {
"content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
"mimetype": "video/mp4"
},
"caption": "Confira esse vídeo incrível!",
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"video": {
"content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF..."
}
}
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Status
Enviar Status de Vídeo
Enviar status de vídeo (story) com legenda opcional
POST
/
api
/
{session}
/
status
/
video
{
"video": {
"content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
"mimetype": "video/mp4"
},
"caption": "Confira esse vídeo incrível!",
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"video": {
"content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF..."
}
}
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Descrição
Este endpoint permite enviar um status de vídeo (story) no WhatsApp. Você pode incluir uma legenda e definir quais contatos poderão visualizar o status.Parâmetros de URL
string
required
ID único da sessão autenticada
Corpo da Requisição
object
required
string
Legenda do vídeo
array
Array de JIDs dos contatos que poderão visualizar o status. Se não informado, o status será visível para todos os contatos.Formato do JID:
["5511999999999@s.whatsapp.net"]{
"video": {
"content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
"mimetype": "video/mp4"
},
"caption": "Confira esse vídeo incrível!",
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"video": {
"content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF..."
}
}
Resposta
boolean
required
Indica se o status foi enviado com sucesso
string
ID da mensagem de status enviada
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Códigos de Status
200- Status enviado com sucesso400- Parâmetros inválidos401- Não autorizado500- Erro no servidor
Exemplo de Uso
curl -X POST https://api.wappfy.com.br/api/my-session/status/video \
-H "Content-Type: application/json" \
-d '{
"video": {
"content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
"mimetype": "video/mp4"
},
"caption": "Confira esse vídeo incrível!"
}'
const session = 'my-session';
// Ler vídeo e converter para base64
const fs = require('fs');
const videoBuffer = fs.readFileSync('caminho/para/video.mp4');
const base64Video = videoBuffer.toString('base64');
const response = await fetch(`https://api.wappfy.com.br/api/${session}/status/video`, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
video: {
content: base64Video,
mimetype: 'video/mp4'
},
caption: 'Confira esse vídeo incrível!',
participants: ['5511999999999@s.whatsapp.net']
})
});
const data = await response.json();
console.log(data);
import requests
import base64
session = 'my-session'
# Ler vídeo e converter para base64
with open('caminho/para/video.mp4', 'rb') as video_file:
base64_video = base64.b64encode(video_file.read()).decode('utf-8')
payload = {
'video': {
'content': base64_video,
'mimetype': 'video/mp4'
},
'caption': 'Confira esse vídeo incrível!',
'participants': ['5511999999999@s.whatsapp.net']
}
response = requests.post(
f'https://api.wappfy.com.br/api/{session}/status/video',
json=payload
)
data = response.json()
print(data)
Notas
- Status são conteúdos temporários (Stories) que desaparecem após 24 horas
- Se o parâmetro
participantsnão for informado, o status será visível para todos os contatos - O vídeo deve ser codificado em base64
- Formatos de vídeo suportados: MP4, AVI, MKV, MOV
- Recomenda-se manter o vídeo com duração máxima de 30 segundos para melhor compatibilidade
Authorizations
Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)
Path Parameters
Nome da sessão (instanceName)
Body
application/json
Response
201 - undefined
