API Cloud

Messaggi di richiesta di posizione

I messaggi di richiesta di posizione contengono corpo del testo e il pulsante Invia posizione. Quando un utente di WhatsApp tocca il pulsante, viene mostrata una schermata di condivisione della posizione che l'utente può usare per condividere la propria posizione.


Una volta che l'utente ha condiviso la propria posizione, viene attivato un webhook messaggi contenente i dettagli sulla posizione dell'utente.

Invio di messaggi di richiesta di posizione

Usa l'endpoint POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages per inviare un messaggio di richiesta di posizione a un utente di WhatsApp.

Sintassi della richiesta

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Corpo del post

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

Parametri del corpo del post

SegnapostoDescrizioneValore di esempio

<BODY_TEXT>

Stringa

Obbligatorio.

Testo del corpo del messaggio. URL supportati.

Massimo 1024 caratteri.

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

Risposta

In caso di azione eseguita correttamente:

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

Contenuto della risposta

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

Quando l'utente di WhatsApp condivide la propria posizione nella risposta al tuo messaggio, viene attivato un webhook messaggi contenente i dettagli sulla posizione dell'utente.

{
  "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"
        }
      ]
    }
  ]
}

Contenuto del webhook

SegnapostoDescrizioneValore di esempio

<LOCATION_ADDRESS>

Stringa

Indirizzo della posizione.

Questo parametro sarà disponibile solo se l'utente di WhatsApp sceglie di condividerlo.

1071 5th Ave, New York, NY 10128

<LOCATION_LATITUDE>

Numero

Latitudine in gradi decimali della posizione.

40.782910059774

<LOCATION_LONGITUDE>

Numero

Longitudine in gradi decimali della posizione.

-73.959075808525

<LOCATION_NAME>

Stringa

Nome della posizione.

Questo parametro sarà disponibile solo se l'utente di WhatsApp sceglie di condividerlo.

Solomon R. Guggenheim Museum

<TIMESTAMP>

Stringa

Indicazione temporale UNIX relativa all'elaborazione del messaggio dell'utente di WhatsApp da parte dei nostri server.

1702920965

<WHATSAPP_BUSINESS_ACCOUNT_ID>

Stringa

ID dell'account WhatsApp Business.

102290129340398

<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>

Stringa

Numero di telefono WhatsApp Business visualizzato.

15550783881

<WHATSAPP_BUSINESS_PHONE_NUMBER>

Stringa

Numero di telefono WhatsApp Business.

15550783881

<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>

Stringa

ID numero di telefono WhatsApp Business.

106540352242922

<WHATSAPP_CONTEXT_MESSAGE_ID>

Stringa

ID del messaggio di WhatsApp al quale l'utente sta rispondendo.

wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1QjJGRjI1RDY0RkE4Nzg4QzcA

<WHATSAPP_MESSAGE_ID>

Stringa

ID del messaggio di WhatsApp dell'utente.

wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA=

<WHATSAPP_USER_ID>

Stringa

ID WhatsApp dell'utente di WhatsApp.

16505551234

<WHATSAPP_USER_NAME>

Stringa

Nome dell'utente di WhatsApp.

Pablo Morales

Esempio di richiesta

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

Esempio di risposta

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

Esempio di 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"
        }
      ]
    }
  ]
}