Skip to main content
I webhook inviano l’attività del tuo store — nuovi ordini, aggiornamenti su pagamenti e payout, stato dello store e delle stampanti — a qualsiasi altro sistema in tempo reale, come richiesta HTTP POST. Sono il modo per collegare storekit a software con cui storekit non ha un’integrazione nativa: il tuo back office, un CRM, uno strumento di cucina o consegna oppure una piattaforma di automazione.
Non esiste alcuna integrazione nativa per strumenti di terze parti arbitrari (per esempio Blinq). Se uno strumento non è documentato nella sezione Integrazioni di questa documentazione, storekit non ha un connettore dedicato. I webhook sono la via supportata, sviluppati dal tuo sviluppatore o dal fornitore dello strumento.

I webhook richiedono un abbonamento

I webhook sono una funzionalità a pagamento. Se il tuo account non li include, la pagina dei webhook mostra un pannello intitolato Build custom integrations with Webhooks con un pulsante Upgrade to enable webhooks invece della schermata di configurazione. Se vedi quel pulsante, contatta il supporto per valutare l’aggiunta dei webhook al tuo piano.

Dove si trovano i webhook nella dashboard

  1. Nella barra laterale della dashboard vai su SettingsDevelopers
  2. Nel pannello Webhooks — “Send realtime storekit data to external services and custom integrations” — clicca Enable Webhooks
  3. Una volta abilitati i webhook, lo stesso pulsante diventa Manage Webhooks
Non esiste una voce Webhooks direttamente sotto Settings. I webhook si raggiungono da SettingsDevelopers, dove si trovano anche le API Keys per gli account con accesso all’API.

Gli endpoint si gestiscono in un portale incorporato

Dopo aver abilitato i webhook, storekit mostra un portale webhook sicuro incorporato nella pagina. Tutto ciò che riguarda gli endpoint avviene dentro quel portale incorporato e non nelle schermate di storekit:
  • Registrare gli URL degli endpoint e scegliere quali tipi di eventi riceve ciascuno
  • Consultare tentativi di consegna, payload e codici di risposta
  • Inviare eventi di test, ritentare le consegne fallite e recuperare quelle perse
  • Copiare il signing secret usato per verificare i payload

Prossimi passi

Panoramica sui webhook

Come funzionano i webhook, conferme di ricezione e basi di sicurezza.

Configurazione dei webhook

Abilita i webhook, registra un endpoint e testalo.

Eventi webhook

Tutti i tipi di evento che storekit può inviare, con payload di esempio.

Introduzione per sviluppatori

L’accesso diretto all’API, in early access e concesso caso per caso.