Skip to main content

Webhook para mensagens de Imagem

Descrição:

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

Payload do Webhook:

Quando uma mensagem de imagem é 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": "imageMessage",
"owner": "ID_DO_PROPRIETARIO",
"messageTimestamp": TIMESTAMP,
"pushName": "NOME_PUSH",
"fromMe": BOOLEAN,
"image": {
"url": "URL_DA_IMAGEM",
"mimeType": "TIPO_DO_MIME",
"fileLength": "TAMANHO_DO_ARQUIVO",
"height": ALTURA,
"width": LARGURA,
"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á imageMessage para mensagens de imagem.
  • 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.
  • image: (object) Objeto contendo informações sobre a imagem.
    • url: (string) URL da imagem.
    • mimeType: (string) Tipo do MIME da imagem.
    • fileLength: (string) Tamanho do arquivo da imagem.
    • height: (number) Altura da imagem.
    • width: (number) Largura da imagem.
    • caption: (string) Legenda da imagem. Este campo só é enviado se a imagem tiver uma legenda.

Conclusão

O webhook messages.upsert para mensagens de imagem é uma ferramenta essencial para o monitoramento em tempo real de mensagens de imagem recebidas, fornecendo detalhes importantes sobre as imagens 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.