# Messaggi di posizione WhatsApp

Un messaggio di posizione invia un segnaposto: un punto sulla mappa, con un nome e un indirizzo facoltativi sotto. Questa è la parte di invio; per chiedere a un contatto di condividere la propria posizione, vedi [richieste di posizione](/docs/guides/whatsapp/message-types/interactive/location-requests).

## Inviare una posizione

Imposta `location.latitude` e `location.longitude`:

**TypeScript**

```typescript
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  location: { latitude: 37.7793, longitude: -122.4193 },
});
console.log(msg.id, msg.status);
```

Examples: [TypeScript](/it-it/documentazione/guides/whatsapp/message-types/location.ts.md) · [Python](/it-it/documentazione/guides/whatsapp/message-types/location.py.md) · [Go](/it-it/documentazione/guides/whatsapp/message-types/location.go.md) · [PHP](/it-it/documentazione/guides/whatsapp/message-types/location.php.md) · [CLI](/it-it/documentazione/guides/whatsapp/message-types/location.cli.md) · [MCP](/it-it/documentazione/guides/whatsapp/message-types/location.mcp.md) · [cURL](/it-it/documentazione/guides/whatsapp/message-types/location.curl.md)

La forma completa aggiunge `name` e `address`:

```json
{
  "to": "+16505551234",
  "from": "+13124495648",
  "location": {
    "latitude": 37.7793,
    "longitude": -122.4193,
    "name": "Ferry Building Pickup",
    "address": "1 Market St, San Francisco, CA 94105"
  }
}
```

`address` viene mostrato al destinatario solo quando è impostato anche `name`. `from` è obbligatorio in ogni messaggio di servizio: un numero di proprietà del tuo spazio di lavoro, non uno gestito da Bird.

## Limiti

| Campo       | Vincolo                                                                     | Applicato da                   |
| ----------- | --------------------------------------------------------------------------- | ------------------------------ |
| `latitude`  | obbligatorio, da -90 a 90, gradi decimali                                   | Bird, all'accettazione (`422`) |
| `longitude` | obbligatorio, da -180 a 180, gradi decimali                                 | Bird, all'accettazione (`422`) |
| `name`      | facoltativo, fino a 1000 caratteri                                          | Bird, all'accettazione (`422`) |
| `address`   | facoltativo, fino a 1000 caratteri, mostrato solo quando `name` è impostato | Bird, all'accettazione (`422`) |

La documentazione di WhatsApp elenca `latitude` e `longitude` come obbligatori senza un intervallo numerico dichiarato; il controllo dell'intervallo ±90/±180 e il limite di 1000 caratteri su `name` e `address` sono vincoli propri di Bird.

## Leggere una posizione in entrata

Quando un contatto condivide la propria posizione, spontaneamente o in risposta a una richiesta di posizione, il risultato è un normale messaggio `location` in entrata. Nulla è garantito: un segnaposto grezzo può arrivare senza `name` e senza `address`, e uno in entrata può anche contenere un `url` che rimanda al luogo, cosa che non compare mai in una posizione inviata. La posizione non è un tipo media, quindi non c'è un file da scaricare. Vedi [Ricezione delle posizioni WhatsApp](/docs/guides/whatsapp/receiving-whatsapp/location) per la lettura completa in entrata, il payload `whatsapp.received` e a cosa prestare attenzione.

## Limiti e casi particolari

- **La finestra del servizio clienti deve essere aperta.** L'invio di una posizione è un messaggio di servizio, recapitabile solo all'interno di una finestra aperta; vedi la [finestra del servizio clienti](/docs/guides/whatsapp/message-types#the-customer-service-window) dell'hub.
- **`name` e `address` sono realmente facoltativi in lettura, non facoltativi con un valore di riserva.** Un segnaposto grezzo non ha nessuno dei due, e `address` non compare mai senza `name`. Non dare per scontato che un indirizzo stradale accompagni una coppia di coordinate.
- **Questo non è lo stesso tipo di una richiesta di posizione.** Le [richieste di posizione](/docs/guides/whatsapp/message-types/interactive/location-requests) sono un tipo interattivo che chiede al destinatario la propria posizione; questa pagina ne invia una a loro. Non confondere le due forme di invio.
- **Un tap su una richiesta di posizione ritorna come un normale messaggio `location` in entrata, non come un `interactive_reply`.** Un'integrazione che controlla solo `interactive_reply` per i tap lo perde del tutto; deve anche controllare i messaggi `location` in entrata.

## Prossimi passi

- [Messaggi di servizio WhatsApp](/docs/guides/whatsapp/message-types): la finestra del servizio clienti e il modello condiviso da ogni messaggio di servizio
- [Richieste di posizione](/docs/guides/whatsapp/message-types/interactive/location-requests): chiedere a un contatto la sua posizione invece di inviarne una
- [Invio di messaggi WhatsApp](/docs/guides/whatsapp/sending-whatsapp): la struttura della richiesta, il modello `202` e le strategie sicure per riprovare

## 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)