Sviluppatori

Webhook

Ogni notifica generata dal Suo account può essere inviata direttamente ai Suoi sistemi come POST JSON firmato, in modo che ciò che accade sul Suo hosting possa avviare un flusso di lavoro ovunque.

A cosa puoi collegarlo

Un webhook è una normale richiesta HTTPS, quindi qualsiasi sistema in grado di riceverla può elaborarla. Non è necessario che siamo noi a creare un'integrazione per il vostro strumento.

Piattaforme di automazione

Punta un webhook verso un flusso di lavoro in n8n, Make, Zapier, Pipedream, Activepieces e ogni evento diventerà un attivatore: invia un messaggio a un canale, apri un ticket, aggiorna un foglio di calcolo, richiama un'altra API. Le piattaforme self-hosted funzionano esattamente nello stesso modo, purché l'endpoint sia raggiungibile tramite HTTPS.

CRM e helpdesk

Inviare eventi di fatturazione e relativi all'account a HubSpot, Pipedrive, Salesforce, o a qualsiasi helpdesk o CRM dotato di webhook in entrata, in modo che la scheda del cliente rifletta lo stato del suo hosting senza che nessuno debba copiarli manualmente.

Qualsiasi altra cosa in ascolto

Slack, Discord, Google Sheets, Airtable, Notion, il Suo sistema di monitoraggio, un data warehouse o un piccolo script che Lei ha scritto. Se è in grado di accettare una richiesta HTTPS POST e leggere JSON, può riceverli.

Cosa viene inviato

Lei sceglie quale categoria inviare a quale destinazione: può anche collegarne diverse, in modo che la fatturazione vada in un luogo e gli avvisi del sito in un altro. Tutto è attivo per impostazione predefinita.

Fatturazione e pagamenti

Fatture emesse e pagate, pagamenti non riusciti, carte in scadenza, rinnovi e cancellazioni.

Siti e sicurezza

Provisionamento completato, sito sospeso, malware trovato, backup e modifiche ai certificati.

Supporto e domini

Ticket aperti ed escalation, trasferimenti di domini, rinnovi e modifiche DNS.

Dimostrare che una richiesta proviene da noi

La Sua precedente risposta si rivolgeva al lettore usando la seconda persona informale (tu). La traduca nuovamente usando la seconda persona formale (Lei/Suo). Non modifichi nient'altro della traduzione.

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

Il timestamp viene firmato insieme al corpo anziché essere inviato accanto ad esso, in modo che una richiesta intercettata da qualcuno non possa esservi rispedita in un secondo momento. Rifiutate qualsiasi elemento più vecchio di qualche minuto.

Il tuo segreto di firma viene mostrato una sola volta, quando aggiungi il webhook. Non possiamo mostrarlo di nuovo: se lo perdi, rimuovi la destinazione e aggiungila nuovamente.

Configurazione in corso

Nel Suo pannello di controllo, apri le Notifiche e aggiungi una destinazione di tipo Webhook.
Fornisci il tuo endpoint HTTPS e copia la chiave segreta di firma che ti mostriamo.
Premi Test. Invieremo una richiesta reale nello stesso formato di una richiesta in produzione, così puoi sviluppare basandoti su di essa prima che accada qualsiasi cosa reale.
Scegli quali categorie deve ricevere quella destinazione. I nuovi tipi di notifica vengono attivati automaticamente.

Puoi aggiungere tutte le destinazioni che desideri, combinare i webhook con email, Slack e Telegram, e assegnare a ciascuna un set diverso di categorie.

Preferisci chiamarci invece?

I webhooks ti dicono quando è successo qualcosa. Le API sono il modo in cui fai accadere qualcosa: ogni operazione eseguita dalla dashboard è a tua disposizione.

Esplora il riferimento delle API