{
"image": {
"content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
"mimetype": "image/png"
},
"caption": "Olha essa foto incrível!",
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"image": {
"content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
}
}
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Status
Enviar Status de Imagem
Enviar status de imagem (story) com legenda opcional
POST
/
api
/
{session}
/
status
/
image
{
"image": {
"content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
"mimetype": "image/png"
},
"caption": "Olha essa foto incrível!",
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"image": {
"content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
}
}
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Descrição
Este endpoint permite enviar um status de imagem (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 da imagem
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"]{
"image": {
"content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
"mimetype": "image/png"
},
"caption": "Olha essa foto incrível!",
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"image": {
"content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
}
}
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/image \
-H "Content-Type: application/json" \
-d '{
"image": {
"content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
"mimetype": "image/png"
},
"caption": "Olha essa foto incrível!"
}'
const session = 'my-session';
// Ler imagem e converter para base64
const fs = require('fs');
const imageBuffer = fs.readFileSync('caminho/para/imagem.jpg');
const base64Image = imageBuffer.toString('base64');
const response = await fetch(`https://api.wappfy.com.br/api/${session}/status/image`, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
image: {
content: base64Image,
mimetype: 'image/jpeg'
},
caption: 'Olha essa foto incrível!',
participants: ['5511999999999@s.whatsapp.net']
})
});
const data = await response.json();
console.log(data);
import requests
import base64
session = 'my-session'
# Ler imagem e converter para base64
with open('caminho/para/imagem.jpg', 'rb') as image_file:
base64_image = base64.b64encode(image_file.read()).decode('utf-8')
payload = {
'image': {
'content': base64_image,
'mimetype': 'image/jpeg'
},
'caption': 'Olha essa foto incrível!',
'participants': ['5511999999999@s.whatsapp.net']
}
response = requests.post(
f'https://api.wappfy.com.br/api/{session}/status/image',
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 - A imagem deve ser codificada em base64
- Formatos de imagem suportados: JPEG, PNG, GIF, WebP
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
