# Sentilo quando arriva una vendita.

> Ricevi una notifica push per ogni ordine Shopify, WooCommerce o Stripe. Punta il webhook del tuo store su Pocket Alert e scopri ogni vendita e ogni rimborso nel momento in cui arriva.

<!-- source: https://pocketalert.app/it/use-cases/ecommerce-order-alerts -->

Ultimo aggiornamento: 2026-08-11

Ogni nuovo ordine da Shopify, WooCommerce o dal tuo negozio personalizzato arriva sul telefono con numero d'ordine, totale e cliente. Senti il cha-ching appena arriva una vendita.

## Tre passaggi per le notifiche degli ordini

1. **Crea il webhook** — Crea un webhook Pocket Alert con un template GJSON che mappa order_number, total_price e customer, poi copia il suo URL di ricezione.
2. **Collega il negozio** — In Shopify aggiungi un webhook per l'evento Order creation e incolla il tuo URL di ricezione come destinazione.
3. **Senti il cha-ching** — Effettua un ordine di prova. La vendita arriva sul tuo telefono con il totale e il cliente.

## Il tuo negozio, sul tuo telefono

Ogni vendita, rimborso e pagamento fallito arriva sul tuo telefono non appena il tuo negozio invia il webhook.

- **Qualsiasi negozio, senza plugin** — Shopify, WooCommerce, Stripe, Paddle o un negozio personalizzato invia il suo webhook d'ordine direttamente all'URL di Pocket Alert tramite POST.
- **Totale e cliente** — Mappa il totale dell'ordine, il cliente e il prodotto, così la notifica sembra una vera ricevuta invece di un evento grezzo.
- **Vendite, rimborsi, fallimenti** — Un nuovo ordine, un rimborso o un pagamento fallito diventano ciascuno una notifica push separata, inviata dallo stesso webhook del negozio.
- **Rimborsi su un canale dedicato** — Un webhook separato per refunds/create su un'applicazione dedicata suona distintamente dagli ordini ordinari, così un rimborso non si perde nel flusso delle vendite.
- **In meno di un secondo** — L'ordine lascia il negozio e raggiunge il tuo telefono in meno di un secondo, senza dover aggiornare la dashboard.
- **Un canale per negozio** — Assegna a ogni negozio la sua applicazione, così due marchi suonano su due canali che puoi distinguere.

## Collega Shopify

### 1. Crea un webhook Pocket Alert

Definisci un nome e un template GJSON `message` che mappa il payload orders/create di Shopify. Questo restituisce il tuo URL di ricezione.

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Shopify Orders","application_id":"qm47b9pzxzxg","message":"Order #%order_number% · %total_price% %currency% · %customer.first_name% %customer.last_name%"}'
```

La risposta contiene uno slug, che ti dà l'URL di ricezione `https://p4a.me/wh/1234abcd`. Puoi crearlo anche nella pagina [Webhook](https://pocketalert.app/it/webhooks).

### 2. Incolla l'URL di ricezione in Shopify

In Shopify vai su Impostazioni, Notifiche, Webhook, e clicca Crea webhook. Scegli l'evento `Order creation`, il formato JSON, e incolla il tuo URL di ricezione Pocket Alert come destinazione.

### 3. Mappa i campi

Shopify invia tramite POST il JSON dell'ordine al tuo URL di ricezione. Il template viene applicato su di esso: `%order_number%`, `%total_price%`, `%currency%`, `%customer.email%` e `%line_items.0.title%` per il primo prodotto. La [documentazione](https://info.pocketalert.app/api/webhooks/settings.html) elenca per intero i percorsi GJSON.

## FAQ

### Come ricevo una notifica per i nuovi ordini?

Crea un webhook in Pocket Alert con un template per i messaggi, poi incolla il suo URL di ricezione in Shopify, alla voce Impostazioni, Notifiche, Webhook. Shopify invia il webhook orders/create per ogni ordine e Pocket Alert lo trasforma in una notifica push.

### La notifica può mostrare il totale e il cliente?

Sì. Il tuo template GJSON prende i campi direttamente dal payload di Shopify — %order_number%, %total_price%, %currency% e %customer.first_name% — così la notifica riporta "Ordine #1001 · 125.00 USD · Jane".

### Quali piattaforme sono supportate?

Shopify, WooCommerce, BigCommerce e qualsiasi negozio personalizzato che invia un webhook tramite POST. Mappa i campi del payload di ogni piattaforma nel template: non serve alcun plugin oltre al webhook nativo che ciascuna piattaforma già offre.

### Un rimborso può distinguersi da una vendita?

Sì. Crea un webhook Pocket Alert separato per orders/create e un altro per refunds/create, ciascuno con la propria applicazione, così i rimborsi suonano su un canale distinguibile dalle vendite ordinarie.

### Gestisco due negozi. Posso tenerli separati?

Assegna a ogni negozio una propria applicazione Pocket Alert. Due marchi, due canali, e la notifica ti dice quale dei due ha suonato.

### Posso rendere più rumoroso un ordine importante?

Sì. Ogni messaggio ha un livello, da silent (-2) a critical (2). Se invii grandi importi dal tuo backend con livello high, arrivano come notifiche push time-sensitive che superano la Full immersion di iPhone, mentre un riepilogo notturno dei ricavi inviato con livello silent finisce nella cronologia senza suono. Anche un webhook può avere un proprio default_level, così il webhook per i grandi ordini suona separatamente dal flusso ordinario.
