> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifiche ordine ai clienti

> Notifiche SMS ed email che storekit invia ai clienti durante il ciclo di vita dell'ordine: conferma, aggiornamenti di stato, ritardi, ritiro e template personalizzati.

storekit invia automaticamente notifiche SMS ed email ai clienti nei momenti chiave del ciclo di vita dell'ordine. Le notifiche SMS vengono inviate tramite Twilio quando il cliente ha fornito un numero di telefono al checkout e lo store ha attivate le **Notifiche di testo (SMS)**.

## Attivare le notifiche SMS

Le notifiche SMS sono **disattivate per impostazione predefinita**. Per attivarle:

1. Nella dashboard, vai su **Stores → \[il tuo store] → Impostazioni → Operazioni → Notifiche ordine → Inviate ai clienti → Notifiche di testo (SMS)**.
2. Seleziona **Notifiche di testo (SMS)**.
3. Facoltativamente imposta un **Nome mittente SMS** (massimo 11 caratteri) per personalizzare l'ID mittente nei paesi supportati — consulta [ID mittente e specifiche regionali](#sender-id--regional-specifics).
4. Seleziona **Salva** nella barra delle impostazioni per applicare le modifiche.

Una volta attivate, i clienti che forniscono un numero di cellulare al checkout riceveranno le notifiche SMS elencate di seguito.

<Note>
  **Non vedo o non riesco ad attivare l'opzione SMS**

  * La casella **Notifiche di testo (SMS)** e il campo **Nome mittente SMS** sono **disabilitati fino a quando il processing dei pagamenti non è attivo** sullo store. Collega prima un provider di pagamento, poi torna alla pagina Operazioni per attivare gli SMS.
  * L'intera sezione **Inviate ai clienti** — comprese le opzioni SMS — **non viene mostrata per gli store order-and-pay (servizio al tavolo in loco)**. Se il tuo store accetta ordini in loco, le opzioni SMS ai clienti non sono disponibili.
</Note>

## Ciclo di vita delle notifiche

La tabella seguente associa a ogni transizione di stato dell'ordine le notifiche cliente (SMS e/o email) inviate automaticamente.

| Transizione di stato                   | SMS                         | Email                       |
| -------------------------------------- | --------------------------- | --------------------------- |
| **Ordine effettuato** (In attesa)      | Conferma ordine             | Conferma ordine             |
| In attesa → Accettato                  | —                           | —                           |
| Accettato → In preparazione            | —                           | —                           |
| In preparazione → Pronto per il ritiro | Pronto per il ritiro        | Pronto per il ritiro        |
| In preparazione → In consegna          | In consegna                 | —                           |
| Ordine in ritardo (qualsiasi stato)    | Ordine in ritardo           | Ordine in ritardo           |
| Orario preordine modificato            | Orario preordine aggiornato | Orario preordine aggiornato |

<Note>
  La transizione **In attesa → Accettato** non attiva una notifica separata al cliente. L'SMS/email di conferma ordine viene inviato immediatamente al momento dell'ordine (quando è ancora In attesa), non quando viene accettato.
</Note>

## Notifiche SMS

### Conferma ordine

Inviata immediatamente dopo che un cliente ha effettuato un ordine.

> Grazie! Abbiamo ricevuto il tuo ordine #`{code}`, puoi tracciarlo qui: `{link}`

### Pronto per il ritiro

Inviata quando un ordine di ritiro viene contrassegnato come pronto.

> Il tuo ordine (#`{code}`) è pronto per il ritiro! Traccia il tuo ordine: `{link}`

Se l'ordine viene contrassegnato come pronto con un tempo di attesa stimato, il messaggio include il ritardo:

> Il tuo ordine #`{code}` sarà pronto per il ritiro fra `{delay}` minuti. Traccia qui: `{link}`

### In consegna

Inviata quando un ordine di consegna viene contrassegnato come in consegna.

> Il tuo ordine #`{code}` è in consegna, tracciato qui: `{link}`

### Ordine in ritardo

Inviata quando un membro dello staff mette in ritardo un ordine dalla dashboard.

> Ci dispiace, il tuo ordine (#`{code}`) è in ritardo di `{delay}` minuti.

### Orario preordine aggiornato

Inviata quando un membro dello staff modifica l'orario programmato di un preordine.

> L'orario del tuo preordine #`{code}` è stato aggiornato, controlla lo stato qui: `{link}`

### Pronto per il ritiro (manuale)

Inviata manualmente da un membro dello staff dalla vista di dettaglio dell'ordine nella dashboard tramite il pulsante **Invia SMS**.

> Il tuo ordine `{venue name}` (#`{code}`) è pronto per il ritiro!

## Cosa puoi personalizzare tu stesso

Alcuni testi delle notifiche sono modificabili direttamente dalla dashboard senza contattare il supporto:

* **Istruzioni per il ritiro** — il messaggio mostrato ai clienti nella pagina di tracciamento dell'ordine dopo aver effettuato un ordine di ritiro (ad esempio "Recati al banco ritiri al piano terra"). Configuralo in **Stores → \[il tuo store] → Impostazioni → Operazioni**.
* **Contenuto della pagina di conferma ordine** — testo aggiuntivo mostrato nella schermata di conferma post-checkout.

Si tratta di messaggi visualizzati all'interno dell'esperienza di ordinazione, non di template SMS o email.

## Cosa richiede l'intervento del team storekit

I veri e propri **template di notifica SMS ed email** — i messaggi inviati ai clienti tramite Twilio e SendGrid — non sono modificabili dalla dashboard. Le modifiche a questi template devono essere configurate dal team storekit. Ciò include:

* SMS di conferma ordine
* SMS di pronto per il ritiro
* SMS di in consegna
* SMS di ordine in ritardo
* SMS di orario preordine aggiornato
* SMS di pronto per il ritiro (manuale)

Se devi modificare il testo di uno di questi messaggi, consulta [Richiedere un template personalizzato](#requesting-a-custom-template) di seguito.

## Template personalizzati

I template SMS predefiniti possono essere sovrascritti a livello di **account**, **brand** o **singolo store**. I template usano la sintassi [Handlebars](https://handlebarsjs.com/) per i contenuti dinamici.

### Gerarchia di override dei template

Quando storekit invia una notifica, cerca un template personalizzato nel seguente ordine:

1. Template a livello di **store** — il più specifico; si applica solo a un singolo store.
2. Template a livello di **brand** — si applica a tutti gli store di un brand, salvo quando esiste un override a livello di store.
3. Template a livello di **account** — si applica a tutti gli store dell'account, salvo quando esiste un override a livello di brand o store.
4. **Template predefinito** — il template integrato di storekit (mostrato nella sezione [Notifiche SMS](#sms-notifications) sopra).

Vince la corrispondenza più specifica. Ad esempio, se imposti un template "Conferma ordine" a livello di account e imposti anche un override a livello di store per una specifica sede, quella sede usa il proprio template mentre tutti gli altri store usano quello a livello di account.

### Variabili Handlebars disponibili

I template personalizzati possono includere le seguenti variabili dinamiche:

| Variabile        | Descrizione                                                | Esempio di output                |
| ---------------- | ---------------------------------------------------------- | -------------------------------- |
| `{{order.code}}` | Il codice di riferimento breve dell'ordine                 | `A1B2`                           |
| `{{venue.name}}` | Il nome dello store o del locale                           | `Gordon Ramsay Plane Food`       |
| `{{link}}`       | Un URL alla pagina di tracciamento dell'ordine del cliente | `https://order.storekit.com/...` |
| `{{delay}}`      | La durata del ritardo (valore numerico)                    | `15`                             |
| `{{delayUnit}}`  | L'unità del valore di ritardo (ad esempio minuti)          | `minutes`                        |

**Esempio di template personalizzato:**

```
Ciao! Il tuo ordine {{venue.name}} #{{order.code}} è confermato. Tracciato qui: {{link}}
```

### Richiedere un template personalizzato

Per configurare un template SMS personalizzato, contatta il team di supporto storekit fornendo le seguenti informazioni:

1. **Testo esatto** — fornisci il testo completo del messaggio, comprese eventuali variabili Handlebars che vuoi usare (vedi la tabella sopra).
2. **Quale notifica** — specifica quale notifica SMS vuoi sovrascrivere (ad esempio "Pronto per il ritiro", "Conferma ordine").
3. **Livello di override** — indica se il template deve applicarsi a livello di **account**, **brand** o **store** e fornisci il nome o l'ID dell'account, del brand o dello store.
4. **Lingua** — se il tuo store opera in una lingua diversa dall'inglese, specifica la lingua del template.

<Tip>
  Contatta il supporto tramite la dashboard o via email **[support@storekit.com](mailto:support@storekit.com)**. Includi tutte e quattro le informazioni sopra elencate, così il team potrà configurare il template senza dover fare domande di follow-up.
</Tip>

## Lingue supportate

I template SMS sono disponibili nelle seguenti lingue. La lingua del messaggio è determinata dall'impostazione di lingua dello store:

* Inglese
* Francese
* Spagnolo
* Tedesco
* Italiano
* Olandese
* Danese
* Svedese

## ID mittente e specifiche regionali

Il nome o il numero che appare come mittente dell'SMS dipende dal paese del cliente.

### Paesi con ID mittente alfanumerici

Nella maggior parte dei paesi (incluso il Regno Unito), l'SMS viene inviato con un nome mittente personalizzato — di solito il nome dello store, troncato a 11 caratteri. Se non è impostato alcun nome dello store, viene usato **storekit** come fallback.

### Stati Uniti e Canada

Gli ID mittente alfanumerici non sono supportati. I messaggi SMS vengono inviati da un numero di telefono dedicato storekit.

### Irlanda

L'Irlanda richiede che gli ID mittente siano pre-registrati nel [Registro degli ID mittente SMS di ComReg](https://v-hub.vodafone.ie/knowledge-centre/what-is-the-sms-sender-id-registry). Poiché la registrazione deve essere completata per ciascun brand, **attualmente storekit invia gli SMS in Irlanda da un numero di telefono standard** anziché da un nome mittente personalizzato. Se hai bisogno di un ID mittente personalizzato per l'Irlanda, contatta il supporto per discutere i requisiti di registrazione.

### Altri paesi con pre-registrazione

Anche diversi altri paesi richiedono la pre-registrazione dell'ID mittente (ad esempio Australia, Singapore, Brasile, Hong Kong, Israele, Turchia, Emirati Arabi Uniti). In queste regioni gli SMS vengono inviati da un numero di telefono standard anziché da un nome personalizzato.

## Notifiche email

Oltre agli SMS, storekit invia notifiche email per i seguenti eventi, quando il cliente ha fornito un indirizzo email:

* **Conferma ordine** — ricevuta con i dettagli dell'ordine
* **Pronto per il ritiro** — comunica al cliente che l'ordine è pronto
* **Ordine in ritardo** — informa il cliente del ritardo con una stima aggiornata
* **Orario preordine aggiornato** — conferma il nuovo orario programmato

Le email vengono inviate dall'indirizzo email configurato per lo store, oppure da `no-reply@storekit.com` come fallback. Per i dettagli sull'autenticazione email (SPF, DKIM, DMARC) e la risoluzione dei problemi di deliverability, consulta [Deliverability delle email](/docs/it/guides/notifications/email-deliverability).

<Tip>
  Per maggiori dettagli sulle notifiche automatiche di ritardo, consulta [Notifiche di ritardo dell'ordine](/docs/it/guides/notifications/order-delay).
</Tip>


## Related topics

- [Notifiche di ritardo dell'ordine](/docs/it/guides/notifications/order-delay.md)
- [Food truck e pop-up](/docs/it/guides/use-cases/food-trucks.md)
- [Auto Ready](/docs/it/guides/orders/advanced/auto-ready.md)
- [Impostazioni operative: tempo di preparazione, accettazione automatica e upsell](/docs/it/guides/store-settings/operations-settings.md)
- [Generazione dei codici ordine](/docs/it/guides/orders/advanced/order-sequence-policy.md)