Come configuro i webhook per inviare i nuovi ordini al mio sistema o via email?

Cosa fa un webhook

Un webhook invia i dettagli di un evento del tuo negozio a un'altra destinazione nel momento in cui accade. Scegli tu l'evento e dove va:

• API: Storeep invia i dati dell'evento a un indirizzo web (URL) del tuo server, del CRM, di uno scenario Zapier o Make o di uno strumento di tracciamento pubblicitario.
• E-mail: Storeep invia i dati dell'evento a un indirizzo email, per esempio per ricevere un'email per ogni nuovo ordine.

Apri Impostazioni > Webhook. Ti serve il permesso Impostazioni.

Molti strumenti hanno già un'app pronta, che è più semplice: Google Sheets, reti di corrieri e pixel pubblicitari. Controlla prima il market delle App.

Creare un webhook

Clicca su Aggiungi un nuovo webhook, compila il modulo e clicca su Aggiungi.

• Attiva: spuntato per impostazione predefinita. Quando è spuntato, gli eventi vengono inviati subito. Togli la spunta per tenere il webhook ma metterlo in pausa.
• Nome: un'etichetta per la tua lista, per esempio "Nuovi ordini CRM".
• Tipo: API o E-mail.
• Evento:
  • Ordine creato: un cliente fa un nuovo ordine.
  • Ordine aggiornato: lo stato o i dettagli di un ordine cambiano.
  • Sessione creata: un nuovo visitatore arriva sul tuo negozio. Solo per il tipo API.
• Formato: Json.
• URL (tipo API): l'indirizzo a cui inviare. La parte https:// viene aggiunta per te, quindi scrivi il resto, come api.example.com/orders.
• Indirizzo e-mail (tipo E-mail): dove arriva l'email.

Un webhook E-mail invia solo eventi degli ordini. Se scegli E-mail con Sessione creata, non viene inviato nulla.

Inserire i dati dell'ordine nell'URL

Puoi inserire qualsiasi campo dei dati dell'evento dentro l'URL con le doppie graffe, {{field_name}}. Per esempio:

example.com/postback?cid={{fbclid}}&payout={{order_total}}

Questo invia l'ID di clic di Facebook e il totale dell'ordine a una piattaforma di tracciamento pubblicitario o di affiliazione, senza bisogno di un server aggiuntivo. Un campo che non esiste diventa vuoto. Per vedere i nomi dei campi, crea un webhook E-mail per lo stesso evento e guarda i dati che ricevi.

La lista dei webhook

Ogni riga mostra Nome, URL / E-mail, Tipo, Evento, Formato e Stato (Attivato o Disattivato). Clicca su una riga per modificarla. Seleziona le righe e scegli Eliminare i webhook per rimuoverle definitivamente. C'è un numero massimo di webhook per negozio e vedi un messaggio quando lo raggiungi.

Puoi creare più webhook per lo stesso evento, per esempio uno verso il CRM e uno verso il tracker pubblicitario.

Quando un invio non riesce

• Il tuo server deve rispondere in fretta con un codice di successo (2xx). Una risposta lenta conta come errore.
• Se il tuo server è irraggiungibile o sovraccarico (una risposta 5xx o 429, oppure nessuna risposta), Storeep riprova diverse volte nei minuti successivi. Vengono ritentati solo i webhook non riusciti, così gli altri non ricevono duplicati.
• Se il tuo server rifiuta la richiesta (una risposta 4xx come 404 o 403), Storeep non riprova, perché l'indirizzo o la sua sicurezza sono sbagliati.
• Quando un webhook fallisce più volte di seguito, il proprietario del negozio riceve una sola email: "Action needed: your Storeep webhook is failing" (azione richiesta: il tuo webhook Storeep non funziona), con nome del webhook, indirizzo, evento e ultimo codice di errore. Dopo che il webhook torna a funzionare, un problema futuro può inviare un nuovo avviso. Puoi disattivare questa email in Notifiche.
• I webhook E-mail vengono inviati una sola volta, senza nuovi tentativi.

Webhook in pausa per un saldo non pagato

Se il tuo negozio ha un importo dovuto non pagato e il portafoglio non riesce a coprirlo, i webhook restano in attesa. Vengono inviati dopo che aggiungi fondi e l'importo viene saldato. Vedi Portafoglio e fatturazione.

Consigli

• Se il tuo server richiede una password o una chiave, inseriscila nella query dell'URL, per esempio ?key=yoursecret.
• Sessione creata scatta per ogni visitatore, e su un negozio molto frequentato possono essere tanti. Usalo solo se il tuo server riesce a gestirlo.
• Per permettere a uno strumento di leggere ordini e prodotti quando vuole, usa invece un token di accesso.