WhatsApp-Standorte empfangen

Eine Stecknadel, die ein Kontakt teilt, kommt als eingehende Nachricht mit location an. Derselbe Zweig beantwortet eine Standortanfrage, die Sie gesendet haben – der einzige interaktive Typ, dessen Antwort hier statt auf interactive_reply landet.

Was ein eingehender Standort enthält

Codebeispiel

{
  "id": "wam_01kyf8u2shzx0v6m9q3bag8tje",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
  "location": {
    "latitude": 37.7793,
    "longitude": -122.4193,
    "name": "Embarcadero Plaza",
    "address": "1 Market St, San Francisco, CA 94105"
  },
  "created_at": "2026-08-25T09:23:14Z"
}

Feld	Was es enthält
latitude	Breitengrad in Dezimalgrad
longitude	Längengrad in Dezimalgrad
name	Der Name des Ortes; fehlt, wenn der Kontakt eine einfache Stecknadel geteilt hat
address	Die Straßenadresse, die WhatsApp nur zusammen mit einem name sendet
url	Ein Link zum Ort, hauptsächlich bei einem Geschäftsstandort, wenn der Client des Absenders einen mitgeliefert hat

Eine einfache Stecknadel auf der Karte enthält nur die beiden Koordinaten und sonst nichts. Behandeln Sie name, address und url daher als optionale Anzeige, die Sie darstellen, wenn sie vorhanden sind, nicht als Felder, auf die Sie sich stützen. Lesen Sie die Koordinaten als JSON-Zahlen und rechnen Sie mit negativen Werten auf der Süd- und Westhalbkugel.

Ein Standort, der auf eine Standortanfrage antwortet

Wenn die Stecknadel auf eine von Ihnen gesendete Standortanfrage antwortet, meldet WhatsApp die Anfrage als Ziel der Antwort und in_reply_to_message_id nennt die Nachricht, die den Button enthielt. Genau das verknüpft eine Antwort mit einer Frage und unterscheidet sie von einer Kontaktinfo-Anfrage, deren Antwort keinen solchen Link enthält.

Nichts anderes kennzeichnet die Stecknadel als Antwort. Ein Kontakt, der seinen Standort unaufgefordert teilt, erzeugt denselben Zweig ohne in_reply_to_message_id. Eine Integration, die auf eine Antwort wartet, prüft daher dieses Feld statt des Zweigs. Das Feld ist in der anderen Richtung keine Garantie: WhatsApp markiert nicht jede Antwort, und die Zuordnung kann fehlschlagen, sodass eine echte Antwort auch ohne das Feld ankommen kann. Der Abschnitt Zitierte Antworten des Hubs beschreibt, wann das passiert und was Sie tun können, wenn die Klassifikation stimmen muss.

Der Webhook-Payload

whatsapp.received enthält den location-Zweig im Event-Envelope: