Skip to main content
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"
  ]
}

{
    "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

​
session
string
required
ID único da sessão autenticada

​
Corpo da Requisição

​
text
string
required
Texto a ser exibido no status
​
backgroundColor
string
Cor de fundo em formato hexadecimal (ex: “#FF5733”)
​
font
number
Número representando a fonte do texto
​
participants
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"
  ]
}

​
Resposta

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

​
Códigos de Status

  • 200 - Status enviado com sucesso
  • 400 - Parâmetros inválidos
  • 401 - Não autorizado
  • 500 - 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
  }'

​
Notas

  • Status são conteúdos temporários (Stories) que desaparecem após 24 horas
  • Se o parâmetro participants nã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 font aceita números que representam diferentes estilos de fonte disponíveis no WhatsApp

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
​
text
string
default:Have a look! https://github.com/
required
​
backgroundColor
string
default:#38b42f
required
​
font
number
default:0
required
​
id
string

Pre-generated status message id

Example:

"BBBBBBBBBBBBBBBBB"

​
contacts
string[]

Contact list to send the status to.

Example:

null

​
linkPreview
boolean
default:true
​
linkPreviewHighQuality
boolean
default:false
⌘I