Skip to main content
POST
/
api
/
{session}
/
status
/
video
{
  "video": {
    "content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
    "mimetype": "video/mp4"
  },
  "caption": "Confira esse vídeo incrível!",
  "participants": [
    "[email protected]",
    "[email protected]"
  ]
}

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

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

​
Corpo da Requisição

​
video
object
required
Objeto contendo os dados do vídeo
​
caption
string
Legenda do vídeo
​
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: ["[email protected]"]
{
  "video": {
    "content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
    "mimetype": "video/mp4"
  },
  "caption": "Confira esse vídeo incrível!",
  "participants": [
    "[email protected]",
    "[email protected]"
  ]
}

​
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/video \
  -H "Content-Type: application/json" \
  -d '{
    "video": {
      "content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
      "mimetype": "video/mp4"
    },
    "caption": "Confira esse vídeo 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
  • 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

​
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