Impostazioni del negozio

Webhook

Configura notifiche di eventi in tempo reale inviate a un endpoint API o indirizzo email quando si verificano sessioni, ordini o aggiornamenti degli ordini nel tuo negozio.

Cosa fanno i webhook

Un webhook è una sottoscrizione a un evento specifico del negozio. Quando quell'evento si verifica, Storeep invia immediatamente i dati dell'evento a un URL che specifichi (tipo API) o a un indirizzo email che specifichi (tipo E-mail). I webhook sono comunemente usati per integrazioni di tracciamento degli ordini, sincronizzazioni CRM, conversioni di piattaforme pubblicitarie e notifiche automatizzate.

Per gestire i webhook, vai su Impostazioni → Webhook.

Limiti dei webhook

Massimo 20 webhook per negozio. Tentare di aggiungerne un 21° restituisce un errore.
I webhook sono elencati dal più recente, paginati a 40 per pagina.

Creare un webhook

Clicca su Aggiungi nuovo webhook.

Interruttore di attivazione

Quando selezionato (il valore predefinito), il webhook è attivo dal momento in cui viene salvato. Gli eventi vengono inviati immediatamente. Deseleziona per salvare il webhook in stato disabilitato senza ricevere eventi. Puoi abilitare o disabilitare un webhook in qualsiasi momento modificandolo.

Nome

Obbligatorio.
Massimo 50 caratteri.
Un'etichetta descrittiva mostrata nell'elenco dei webhook. Esempio: Facebook CAPI, ordine creato.

Tipo

Controlla come viene consegnato il payload dell'evento. Due opzioni:

API: Storeep invia una richiesta HTTP POST contenente i dati dell'evento all'URL specificato.
E-mail: Storeep invia un'email contenente i dati dell'evento all'indirizzo specificato.

Evento

L'evento del negozio che attiva questo webhook. Sono disponibili tre eventi:

Sessione creata: si attiva quando viene creata una nuova sessione del visitatore nel tuo negozio.
Ordine creato: si attiva quando viene effettuato un nuovo ordine.
Ordine aggiornato: si attiva quando lo stato o i dati di un ordine esistente cambiano.

Formato

Il formato dei dati del payload dell'evento. Attualmente un'opzione:

Json: il payload viene inviato come documento JSON.

URL (solo tipo API)

Obbligatorio quando il tipo è API.
Massimo 500 caratteri. Il limite più alto accoglie gli URL che includono più segmenti segnaposto.
Inserisci l'URL dell'endpoint senza il prefisso https://. Viene aggiunto automaticamente. Esempio: api.example.com/events/order.
Segnaposto URL dinamici: qualsiasi campo dal payload dell'evento può essere iniettato nell'URL usando la sintassi a doppia parentesi graffa: {{field_name}}. Ad esempio:
https://example.com/postback?cid={{fbclid}}&payout={{order_total}}
Questo ti permette di inviare dati di conversione alle piattaforme pubblicitarie direttamente dall'URL del webhook senza un server proxy separato.
Se la struttura dell'URL non è valida dopo la risoluzione dei segnaposto, riceverai un errore di validazione.

Indirizzo email (solo tipo e-mail)

Obbligatorio quando il tipo è E-mail.
Deve essere un indirizzo email valido, massimo 127 caratteri.

Modificare un webhook

Clicca su qualsiasi riga del webhook per aprire l'editor. Tutti i campi sono modificabili. Il campo URL viene precompilato solo se il tipo corrente è API; il campo email viene precompilato solo se il tipo corrente è E-mail. Cambiare tipo svuota l'altro campo.

Abilitare e disabilitare i webhook

La casella Attiva in cima all'editor controlla se il webhook si attiva. Lo stato nell'elenco mostra Attivato o Disattivato. Un webhook disabilitato non registra consegne ma non viene eliminato, quindi puoi riabilitarlo in seguito senza riconfigurarlo.

Colonne dell'elenco dei webhook

Nome: etichetta del webhook con data di creazione.
URL / E-mail: l'indirizzo di destinazione.
Tipo: API o E-mail.
Evento: il nome dell'evento (Sessione creata, Ordine creato o Ordine aggiornato).
Formato: Json.
Stato: Attivato o Disattivato.

Eliminare un webhook

Seleziona uno o più webhook e clicca su Elimina webhook. Questa operazione è permanente e interrompe tutte le consegne future per quella sottoscrizione.

Suggerimenti e problemi

Puoi creare più webhook per lo stesso evento, ad esempio inviare Ordine creato sia a un CRM che a una piattaforma pubblicitaria, ciascuno come voce webhook separata.
Se il tuo endpoint richiede l'autenticazione, aggiungi le credenziali alla stringa di query dell'URL usando un {{segnaposto}} proveniente dai dati dell'evento, oppure configura un server proxy che gestisce l'autenticazione prima di inoltrarli all'endpoint reale.
L'evento Sessione creata si attiva per ogni sessione di visitatore unico, il che può essere ad alto volume nei negozi popolari. Iscriviti solo se il tuo endpoint può gestire la portata.