Sviluppatori
Webhook
Ogni notifica generata dal Suo account può essere inviata direttamente ai Suoi sistemi come JSON POST firmato — in questo modo ciò che accade sul Suo hosting può avviare un flusso di lavoro ovunque.
A cosa potete collegarlo
Un webhook è una normale richiesta HTTPS, quindi qualsiasi elemento in grado di riceverla può agire di conseguenza. Non avete bisogno che sviluppiamo un'integrazione per il vostro strumento.
Piattaforme di automazione
Indirizzate un webhook a un flusso di lavoro in n8n, Make, Zapier, Pipedream, Activepieces e ogni evento diventerà un trigger: pubblicate su un canale, aprite un ticket, aggiornate un foglio di calcolo, chiamate un'altra API. Le piattaforme self-hosted funzionano esattamente nello stesso modo, purché l'endpoint sia raggiungibile tramite HTTPS.
CRM e help desk
Invia gli eventi di fatturazione e di account a HubSpot, Pipedrive, Salesforce, o a qualsiasi helpdesk o CRM dotato di webhook in entrata, in modo che il profilo del cliente rifletta le attività del suo hosting senza che nessuno debba copiare i dati manualmente.
Qualsiasi altra cosa in ascolto
Slack, Discord, Google Sheets, Airtable, Notion, il vostro monitoraggio personale, un data warehouse o un piccolo script da voi scritto. Se è in grado di accettare un HTTPS POST e leggere JSON, può ricevere questi dati.
Cosa viene inviato
Scegliete quali categorie inviare a quale destinazione — ed è possibile collegarne diverse, in modo che la fatturazione vada in un posto 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
Provisioning completato, un sito sospeso, malware rilevato, backup e modifiche ai certificati.
Assistenza e domini
Ticket aperti ed inoltrati, trasferimenti di dominio, rinnovi e modifiche DNS.
Dimostrare che una richiesta proviene da noi
Ogni richiesta è firmata con un segreto che solo Lei e noi possediamo. Controlli la firma prima di agire sul corpo — queste intestazioni arrivano con ogni consegna:
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.paidIl timestamp viene firmato insieme al corpo anziché essere inviato accanto ad esso, in modo che una richiesta intercettata non possa essere replicata in seguito contro di voi. Rifiutate qualsiasi elemento risalente a più di pochi minuti prima.
Il segreto di firma viene mostrato una sola volta, quando si aggiunge il webhook. Non possiamo mostrarlo di nuovo: se viene perso, rimuovere la destinazione e aggiungerla nuovamente.
Configurazione in corso
- Nel dashboard, apra Notifiche e aggiunga una destinazione di tipo Webhook.
- Fornisca il Suo endpoint HTTPS e copi il segreto di firma che Le mostriamo.
- Prema Test. Inviamo una richiesta reale nella stessa forma di una effettiva, consentendole di sviluppare su di essa prima che accada qualcosa di concreto.
- Scegliete quali categorie deve ricevere tale destinazione. I nuovi tipi di notifiche vengono attivati automaticamente.
È possibile aggiungere tutte le destinazioni desiderate, combinare webhook con e-mail, Slack e Telegram e assegnare a ciascuna un insieme diverso di categorie.
Preferisce chiamarci telefonicamente?
I webhook informano l'utente quando si è verificato un evento. L'API è lo strumento per determinare un'azione: ogni operazione eseguita dal pannello di controllo è a Sua disposizione.