# WhatsApp-locaties ontvangen

Een pin die een contact deelt komt binnen als een inkomend bericht met `location`. Dezelfde arm beantwoordt een [locatieverzoek](/docs/guides/whatsapp/message-types/interactive/location-requests) dat je hebt verstuurd, het enige interactieve type waarvan het antwoord hier landt in plaats van op `interactive_reply`.

## Wat een inkomende locatie bevat

```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"
}
```

| Veld        | Wat het bevat                                                                                                  |
| ----------- | -------------------------------------------------------------------------------------------------------------- |
| `latitude`  | Breedtegraad in decimale graden                                                                                |
| `longitude` | Lengtegraad in decimale graden                                                                                 |
| `name`      | De naam van de plaats; afwezig als het contact een kale pin deelde                                             |
| `address`   | Het adres, dat WhatsApp alleen samen met een `name` meestuurt                                                  |
| `url`       | Een link naar de plaats, voornamelijk bij een bedrijfslocatie, als de client van de afzender er een meestuurde |

Een kale pin op de kaart bevat alleen de twee coördinaten, dus behandel `name`, `address` en `url` als decoratie die je toont wanneer aanwezig, niet als velden om op te filteren. Lees de coördinaten als JSON-getallen en verwacht negatieve waarden op het zuidelijk en westelijk halfrond.

## Een locatie die een locatieverzoek beantwoordt

Als de pin een locatieverzoek beantwoordt dat je hebt verstuurd, rapporteert WhatsApp de vraag als doel van het antwoord en `in_reply_to_message_id` noemt het bericht dat de knop bevatte. Dat is wat een antwoord aan een vraag koppelt, en het is het verschil met een [contactgegevensverzoek](/docs/guides/whatsapp/message-types/interactive/contact-info-requests), waarvan het antwoord zo'n link niet bevat.

Niets anders markeert de pin als een antwoord. Een contact dat spontaan een locatie deelt produceert dezelfde arm zonder `in_reply_to_message_id`, dus een integratie die op een antwoord wacht controleert dat veld in plaats van de arm. Het veld is geen garantie in de andere richting: WhatsApp markeert niet elk antwoord en de resolutie kan missen, dus een echt antwoord kan zonder dat veld binnenkomen. De hub's [quoted replies](/docs/guides/whatsapp/receiving-whatsapp#quoted-replies) beschrijft wanneer dat gebeurt en wat je doet als de classificatie moet kloppen.

## De webhook-payload

`whatsapp.received` bevat de `location`-arm op de event-envelop:

```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
  }
}
```

## Aandachtspunten

- **Live locatiedeling wordt niet als content gemodelleerd.** Wat binnenkomt is één locatie vastgelegd op één moment, dus een trackingweergave heeft niets om bij te werken. Bouw er geen op dit veld.
- **Een integratie die alleen `interactive_reply` bewaakt mist dit.** Het antwoord op een locatieverzoek komt hier binnen en het antwoord op een contactgegevensverzoek komt binnen op `contact_cards`, dus een handler die alleen taps leest mist beide.
- **Coördinaten zijn wat het apparaat van het contact rapporteerde.** Ze bevatten geen nauwkeurigheidsradius en geen hoogte, en een pin die het contact heeft versleept staat waar die is neergezet. Bevestig een adres in woorden als het correct moet zijn.

## Vervolgstappen

- [Hoe ontvangen werkt](/docs/guides/whatsapp/receiving-whatsapp): de inkomende envelop, media ophalen en de `whatsapp.received`-webhook
- [WhatsApp-locatieberichten](/docs/guides/whatsapp/message-types/location): de verzendzijde van dezelfde arm
- [WhatsApp-locatieverzoeken](/docs/guides/whatsapp/message-types/interactive/location-requests): de knop die om een pin vraagt
- [WhatsApp-events](/docs/guides/whatsapp/events): de volledige eventlijst, via de API of 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)