{
"text": "Olá! Esta é minha história do dia!",
"backgroundColor": "#FF5733",
"font": 1,
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"text": "Bom dia a todos!"
}
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Status
Enviar Status de Texto
Enviar status de texto (story) com texto personalizado e cor de fundo
POST
/
api
/
{session}
/
status
/
text
{
"text": "Olá! Esta é minha história do dia!",
"backgroundColor": "#FF5733",
"font": 1,
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"text": "Bom dia a todos!"
}
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Descrição
Este endpoint permite enviar um status de texto (story) no WhatsApp. Você pode personalizar o texto, cor de fundo e fonte, além de definir quais contatos poderão visualizar o status.Parâmetros de URL
string
required
ID único da sessão autenticada
Corpo da Requisição
string
required
Texto a ser exibido no status
string
Cor de fundo em formato hexadecimal (ex: “#FF5733”)
number
Número representando a fonte do texto
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"]{
"text": "Olá! Esta é minha história do dia!",
"backgroundColor": "#FF5733",
"font": 1,
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"text": "Bom dia a todos!"
}
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/text \
-H "Content-Type: application/json" \
-d '{
"text": "Olá! Esta é minha história do dia!",
"backgroundColor": "#FF5733",
"font": 1
}'
const session = 'my-session';
const response = await fetch(`https://api.wappfy.com.br/api/${session}/status/text`, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
text: 'Olá! Esta é minha história do dia!',
backgroundColor: '#FF5733',
font: 1,
participants: ['5511999999999@s.whatsapp.net']
})
});
const data = await response.json();
console.log(data);
import requests
session = 'my-session'
payload = {
'text': 'Olá! Esta é minha história do dia!',
'backgroundColor': '#FF5733',
'font': 1,
'participants': ['5511999999999@s.whatsapp.net']
}
response = requests.post(
f'https://api.wappfy.com.br/api/{session}/status/text',
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 cor de fundo deve ser fornecida em formato hexadecimal (ex: “#FF5733”)
- O campo
fontaceita números que representam diferentes estilos de fonte disponíveis no WhatsApp
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
