# WhatsApp-Standorte empfangen

Eine Stecknadel, die ein Kontakt teilt, kommt als eingehende Nachricht mit `location` an. Derselbe Zweig beantwortet eine [Standortanfrage](/docs/guides/whatsapp/message-types/interactive/location-requests), die Sie gesendet haben – der einzige interaktive Typ, dessen Antwort hier statt auf `interactive_reply` landet.

## Was ein eingehender Standort enthält

```json
{
  "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](/docs/guides/whatsapp/message-types/interactive/contact-info-requests), 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](/docs/guides/whatsapp/receiving-whatsapp#quoted-replies) 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:

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:23:14.507Z",
  "data": {
    "whatsapp_id": "wam_01kyf8u2shzx0v6m9q3bag8tje",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "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"
    },
    "tags": null,
    "metadata": null
  }
}
```

## Worauf Sie achten sollten

- **Live-Standortfreigabe wird nicht als Inhalt modelliert.** Was ankommt, ist ein einzelner Standort zu einem bestimmten Zeitpunkt. Eine Tracking-Ansicht hat daher nichts, woraus sie sich aktualisieren könnte. Bauen Sie keine auf diesem Feld auf.
- **Eine Integration, die nur `interactive_reply` überwacht, verpasst dies.** Die Antwort auf eine Standortanfrage kommt hier an, die Antwort auf eine Kontaktinfo-Anfrage kommt auf `contact_cards` an. Ein Handler, der nur Taps liest, übersieht beides.
- **Koordinaten sind das, was das Gerät des Kontakts gemeldet hat.** Sie enthalten keinen Genauigkeitsradius und keine Höhe, und eine Stecknadel, die der Kontakt verschoben hat, liegt dort, wo er sie hinverschoben hat. Bestätigen Sie eine Adresse in Worten, wenn sie stimmen muss.

## Nächste Schritte

- [So funktioniert der Empfang](/docs/guides/whatsapp/receiving-whatsapp): das eingehende Envelope, der Medienabruf und der `whatsapp.received`-Webhook
- [WhatsApp-Standortnachrichten](/docs/guides/whatsapp/message-types/location): die Sendeseite desselben Zweigs
- [WhatsApp-Standortanfragen](/docs/guides/whatsapp/message-types/interactive/location-requests): der Button, der nach einer Stecknadel fragt
- [WhatsApp-Events](/docs/guides/whatsapp/events): die vollständige Event-Liste, über die API oder Webhooks

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)