Cloud API

Standortanfragenachrichten

Standortanfragenachrichten zeigen einen Nachrichtentext und einen Button zum Senden des Standorts an. Wenn ein*e WhatsApp-Benutzer*in auf den Button tippt, wird ein Bildschirm zum Teilen des Standorts angezeigt, über den Benutzer*innen ihren Standort teilen können.


Sobald der Benutzer seinen Standort teilt, wird ein messages-Webhook ausgelöst, der die Standortdetails des*der Benutzer*in enthält.

Standortanfragenachrichten senden

Verwende den Endpunkt POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages, um eine Standortanfragenachricht an eine*n WhatsApp-Benutzer*in zu senden.

Anfragesyntax

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Anfrageinhalt

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "type": "interactive",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "interactive": {
    "type": "location_request_message",
    "body": {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "send_location"
    }
  }
}

Parameter für den Beitragstext

PlatzhalterBeschreibungBeispielwert

<BODY_TEXT>

String

Erforderlich.

Haupttext der Nachricht. Es werden URLs unterstützt.

Maximal 1024 Zeichen.

Let's start with your pickup. You can either manually *enter an address* or *share your current location*.

<WHATSAPP_USER_PHONE_NUMBER>

String

Required.

WhatsApp user phone number.

+16505551234

Antwort

Bei Erfolg:

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "<WHATSAPP_USER_PHONE_NUMBER>",
      "wa_id": "<WHATSAPP_USER_ID>"
    }
  ],
  "messages": [
    {
      "id": "<WHATSAPP_MESSAGE_ID>",
      "message_status": "<PACING_STATUS>"
    }
  ]
}

Antwortinhalt

PlaceholderDescriptionSample Value

<WHATSAPP_USER_PHONE_NUMBER>

String

WhatsApp user's WhatsApp phone number. May not match wa_id value.

+16505551234

<WHATSAPP_USER_ID>

String

WhatsApp user's WhatsApp ID. May not match input value.

16505551234

<WHATSAPP_MESSAGE_ID>

String

WhatsApp Message ID. This ID appears in associated messages webhooks, such as sent, read, and delivered webhooks.

wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI4MjZGRDA0OUE2OTQ3RkEyMzcA

<PACING_STATUS>

String

Indicates template pacing status. The message_status property is only included in responses when sending a template message that uses a template that is being paced.

wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI4MjZGRDA0OUE2OTQ3RkEyMzcA

Webhook

Wenn ein*e WhatsApp-Benutzer*in als Antwort auf deine Nachricht seinen Standort teilt, wird ein messages-Webhook ausgelöst, der die Standortdetails des*der Benutzer*in enthält.

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "context": {
                  "from": "<WHATSAPP_BUSINESS_PHONE_NUMBER>",
                  "id": "<WHATSAPP_CONTEXT_MESSAGE_ID>"
                },
                "from": "<WHATSAPP_USER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "location": {
                  "address": "<LOCATION_ADDRESS>",
                  "latitude": <LOCATION_LATITUDE>,
                  "longitude": <LOCATION_LONGITUDE>,
                  "name": "<LOCATION_NAME>"
                },
                "type": "location"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Webhook-Inhalt

PlatzhalterBeschreibungBeispielwert

<LOCATION_ADDRESS>

String

Adresse des Standorts.

Dieser Parameter wird nur angezeigt, wenn der*die WhatsApp-Benutzer*in ihn teilen möchte.

1071 5th Ave, New York, NY 10128

<LOCATION_LATITUDE>

Zahl

Breitengrad des Standorts in Dezimalgrad.

40.782910059774

<LOCATION_LONGITUDE>

Zahl

Längengrad des Standorts in Dezimalgrad.

-73.959075808525

<LOCATION_NAME>

String

Name des Standorts.

Dieser Parameter wird nur angezeigt, wenn der*die WhatsApp-Benutzer*in ihn teilen möchte.

Solomon R. Guggenheim Museum

<TIMESTAMP>

String

UNIX-Zeitstempel, der angibt, wann unsere Server die Nachricht des*der WhatsApp-Benutzer*in verarbeitet haben.

1702920965

<WHATSAPP_BUSINESS_ACCOUNT_ID>

String

WhatsApp-Unternehmenskonto-ID.

102290129340398

<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>

String

Anzeigenummer der WhatsApp-Unternehmenstelefonnummer.

15550783881

<WHATSAPP_BUSINESS_PHONE_NUMBER>

String

WhatsApp-Unternehmenstelefonnummer.

15550783881

<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>

String

ID der WhatsApp-Unternehmenstelefonnummer.

106540352242922

<WHATSAPP_CONTEXT_MESSAGE_ID>

String

ID der WhatsApp-Nachricht, auf die der*die Benutzer*in antwortet.

wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1QjJGRjI1RDY0RkE4Nzg4QzcA

<WHATSAPP_MESSAGE_ID>

String

ID der WhatsApp-Nachricht des*der Benutzer*in.

wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA=

<WHATSAPP_USER_ID>

String

WhatsApp-ID des*der WhatsApp-Benutzer*in.

16505551234

<WHATSAPP_USER_NAME>

String

Name des*der WhatsApp-Benutzer*in.

Pablo Morales

Beispielanfrage

curl 'https://graph.facebook.com/v21.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "type": "interactive",
  "to": "+16505551234",
  "interactive": {
    "type": "location_request_message",
    "body": {
      "text": "Let us start with your pickup. You can either manually *enter an address* or *share your current location*."
    },
    "action": {
      "name": "send_location"
    }
  }
}'

Beispielantwort

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBJCNUQ5RUNBNTk3OEQ2M0ZEQzgA"
    }
  ]
}

Beispiel-Webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Pablo Morales"
                },
                "wa_id": "16505551234"
              }
            ],
            "messages": [
              {
                "context": {
                  "from": "15550783881",
                  "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1QjJGRjI1RDY0RkE4Nzg4QzcA"
                },
                "from": "16505551234",
                "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA=",
                "timestamp": "1702920965",
                "location": {
                  "address": "1071 5th Ave, New York, NY 10128",
                  "latitude": 40.782910059774,
                  "longitude": -73.959075808525,
                  "name": "Solomon R. Guggenheim Museum"
                },
                "type": "location"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}