Skip to main content

Webhook para mensagens de Localização

Descrição:​

O evento messages.upsert é disparado sempre que uma mensagem de localização é inserida ou atualizada. Este webhook é crucial para empresas e desenvolvedores que precisam monitorar o envio e recebimento de localizações em tempo real.

Payload do Webhook:​

Mensagem de Localização:​

Quando uma mensagem de localização é recebida, o payload enviado ao endpoint do webhook configurado será o seguinte:

{
  "eventType": "messages.upsert",
  "instance": "8ed9c4fac80ab70d541b7c5ead1f5bcc",
  "sender": "556181489175@s.whatsapp.net",
  "recipient": "556192008823@s.whatsapp.net",
  "messageType": "locationMessage",
  "owner": "8ed9c4fac80ab70d541b7c5ead1f5bcc",
  "messageTimestamp": 1696092388,
  "pushName": "Aline",
  "fromMe": false,
  "location": {
    "degreesLatitude": -16.02836036682129,
    "degreesLongitude": -47.98688888549805,
    "jpegThumbnail": "DADOS_DA_MINIATURA_JPEG"
  }
}

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á locationMessage para mensagens de localização.
  • 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.

Propriedades do Objeto location:​

  • degreesLatitude: (number) Graus de latitude da localização.
  • degreesLongitude: (number) Graus de longitude da localização.
  • jpegThumbnail: (string) Miniatura JPEG da localização, se disponível.

Conclusão​

O webhook messages.upsert para mensagens de localização possibilita o monitoramento em tempo real de localizações transmitidas, viabilizando uma integração mais eficaz e minuciosa. Para qualquer dúvida ou problema, por favor, contacte o nosso suporte.