Dezvoltatori

Webhook-uri

Fiecare notificare generată de contul dumneavoastră poate fi trimisă direct către propriile sisteme ca un JSON POST semnat — astfel încât ceea ce se întâmplă pe găzduirea dumneavoastră poate declanșa un flux de lucru oriunde altundeva.

Toată documentația pentru dezvoltatori →

La ce îl puteți conecta

Un webhook este o solicitare HTTPS obișnuită, astfel încât orice element care o poate primi poate acționa în baza ei. Nu aveți nevoie ca noi să construim o integrare pentru instrumentul dumneavoastră.

Platforme de automatizare

Indicați un webhook către un flux de lucru din n8n, Make, Zapier, Pipedream, Activepieces și fiecare eveniment devine un declanșator — postați pe un canal, deschideți un tichet, actualizați o foaie de calcul, apelați un alt API. Platformele găzduite pe cont propriu funcționează exact în același mod, atâta timp cât punctul final este accesibil prin HTTPS.

CRM-uri și birouri de asistență

Trimiteți evenimentele de facturare și de cont către HubSpot, Pipedrive, Salesforce sau către orice helpdesk sau CRM cu un webhook de intrare, astfel încât înregistrarea clientului să reflecte activitatea găzduirii acestuia fără a fi nevoie de copierea manuală a datelor.

Orice altceva care ascultă

Slack, Discord, Google Sheets, Airtable, Notion, propria dumneavoastră monitorizare, un depozit de date sau un mic script pe care l-ați scris. Dacă poate accepta o solicitare HTTPS POST și poate citi JSON, le poate primi pe acestea.

Ce se trimite

Dumneavoastră alegeți ce categorii merg către ce destinație — și puteți conecta mai multe, astfel încât facturarea să poată merge într-un loc, iar alertele site-ului în altul. Totul este activat în mod prestabilit.

Facturare și plăți

Facturi emise și plătite, plăți eșuate, carduri care urmează să expire, reînnoiri și anulări.

Site-uri și securitate

Aprovizionare finalizată, un site suspendat, malware găsit, copii de rezervă și modificări de certificate.

Asistență și domenii

Tichete deschise și escaladate, transferuri de domenii, reînnoiri și modificări DNS.

Dovedirea faptului că o solicitare provine de la noi

Fiecare solicitare este semnată cu un secret pe care îl deținem doar dumneavoastră și noi. Verificați semnătura înainte de a acționa asupra corpului — aceste anteturi sosesc cu fiecare livrare:

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

Marca temporală este semnată împreună cu corpul mesajului, nu trimisă alături de acesta, astfel încât o solicitare interceptată să nu poată fi reluată ulterior împotriva dumneavoastră. Respingeți orice este mai vechi de câteva minute.

Secretul dumneavoastră de semnare este afișat o singură dată, atunci când adăugați webhookul. Nu îl putem afișa din nou — dacă îl pierdeți, eliminați destinația și adăugați-o din nou.

Se configurează unul

  1. În tabloul dvs. de bord, deschideți Notificări și adăugați o destinație de tip Webhook.
  2. Introduceți punctul final HTTPS și copiați secretul de semnare pe care vi-l afișăm.
  3. Apăsați Test. Trimitem o solicitare reală în aceeași formă ca una în producție, astfel încât să puteți construi pe baza acesteia înainte de a se produce ceva real.
  4. Alegeți ce categorii ar trebui să primească acea destinație. Tipurile noi de notificări sunt activate automat.

Puteți adăuga oricâte destinații doriți, puteți combina webhook-urile cu e-mailul, Slack și Telegram și puteți atribui fiecăreia un set diferit de categorii.

Preferați să ne contactați telefonic?

Webhook-urile vă informează când s-a întâmplat ceva. API-ul reprezintă modalitatea prin care declanșați o acțiune — fiecare operațiune pe care o efectuează tabloul de bord vă stă la dispoziție.

Răsfoiți documentația de referință API