Skip to main content

Webhook para mensagens de Vídeo

Descrição:​

O evento messages.upsert é acionado sempre que uma mensagem de vídeo é inserida ou atualizada. Este webhook é vital para desenvolvedores e empresas que precisam gerenciar informações sobre mensagens de vídeo em tempo real.

Payload do Webhook:​

Quando uma mensagem de vídeo é recebida, o payload enviado ao endpoint do webhook configurado será semelhante ao abaixo:

{
  "eventType": "messages.upsert",
  "instance": "ID_DA_INSTANCIA",
  "sender": "NUMERO_DO_REMETENTE@s.whatsapp.net",
  "recipient": "NUMERO_DO_DESTINATARIO@s.whatsapp.net",
  "messageType": "videoMessage",
  "owner": "ID_DO_PROPRIETARIO",
  "messageTimestamp": TIMESTAMP,
  "pushName": "NOME_PUSH",
  "fromMe": BOOLEAN,
  "video": {
    "url": "URL_DO_VIDEO",
    "mimetype": "TIPO_DO_MIME",
    "fileSha256": "SHA256_DO_ARQUIVO",
    "fileLength": "TAMANHO_DO_ARQUIVO",
    "seconds": SEGUNDOS,
    "mediaKey": "CHAVE_DE_MIDIA",
    "height": ALTURA,
    "width": LARGURA,
    "fileEncSha256": "SHA256_ENCRYP",
    "directPath": "CAMINHO_DIRETO",
    "mediaKeyTimestamp": "TIMESTAMP_DA_CHAVE_DE_MIDIA",
    "jpegThumbnail": "THUMBNAIL_JPEG",
    "streamingSidecar": "SIDECAR_DE_STREAMING",
    "caption": "LEGENDA"
  }
}

Detalhamento das Propriedades do Payload:​

  • eventType: (string) Tipo do evento. Será sempre messages.upsert para este webhook.
  • instance: (string) ID da instância que está enviando ou recebendo a mensagem.
  • sender: (string) Número de telefone do remetente no formato internacional, seguido por @s.whatsapp.net.
  • recipient: (string) Número de telefone do destinatário no formato internacional, seguido por @s.whatsapp.net.
  • messageType: (string) Tipo da mensagem. Será videoMessage para mensagens de vídeo.
  • owner: (string) ID do proprietário da instância.
  • messageTimestamp: (number) Timestamp da data e hora da inserção ou atualização da mensagem.
  • pushName: (string) Nome exibido do remetente da mensagem.
  • fromMe: (boolean) true se a mensagem foi enviada pela instância, false se foi recebida por ela.
  • video: (object) Objeto contendo informações sobre o vídeo.
    • url: (string) URL do vídeo.
    • mimetype: (string) Tipo do MIME do vídeo.
    • fileSha256: (string) SHA-256 do arquivo de vídeo.
    • fileLength: (string) Tamanho do arquivo de vídeo.
    • seconds: (number) Duração do vídeo em segundos.
    • mediaKey: (string) Chave de mídia do vídeo.
    • height: (number) Altura do vídeo.
    • width: (number) Largura do vídeo.
    • fileEncSha256: (string) SHA-256 do arquivo de vídeo criptografado.
    • directPath: (string) Caminho direto para o vídeo.
    • mediaKeyTimestamp: (number) Timestamp da chave de mídia.
    • jpegThumbnail: (string) Thumbnail JPEG do vídeo.
    • streamingSidecar: (string) Sidecar de Streaming do vídeo.
    • caption: (string) Legenda do vídeo. Este campo só é enviado se o vídeo tiver uma legenda.

Conclusão​

O webhook messages.upsert para mensagens de vídeo é uma ferramenta essencial para o monitoramento em tempo real de mensagens de vídeo recebidas, fornecendo detalhes importantes sobre os vídeos e possibilitando uma gestão de comunicação mais refinada e responsiva. Para qualquer dúvida ou suporte adicional, por favor, entre em contato com nossa equipe de suporte.