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

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

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

​
Corpo da Requisição

​
image
object
required
Objeto contendo os dados da imagem
​
caption
string
Legenda da imagem
​
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"]
{
  "image": {
    "content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
    "mimetype": "image/png"
  },
  "caption": "Olha essa foto incrível!",
  "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/image \
  -H "Content-Type: application/json" \
  -d '{
    "image": {
      "content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
      "mimetype": "image/png"
    },
    "caption": "Olha essa foto incrível!"
  }'

​
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 imagem deve ser codificada em base64
  • Formatos de imagem suportados: JPEG, PNG, GIF, WebP

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
​
file
object
required
​
id
string

Pre-generated status message id

Example:

"BBBBBBBBBBBBBBBBB"

​
contacts
string[]

Contact list to send the status to.

Example:

null

​
caption
string

Response

201 - undefined