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.