Dezvoltatori

Webhooks

Fiecare notificare generată de contul tău poate fi trimisă direct către propriile tale sisteme sub formă de cerere JSON POST semnată — astfel încât ceea ce se întâmplă pe găzduirea ta poate declanșa un flux de lucru în orice altă parte.

La ce îl poți conecta

Un webhook este o cerere HTTPS obișnuită, așa că orice sistem care poate primi una o poate procesa. Nu este nevoie ca noi să construim o integrare pentru unealta dumneavoastră.

Platforme de automatizare

Indică un webhook spre un flux de lucru în n8n, Make, Zapier, Pipedream, Activepieces și fiecare eveniment devine un declanșator — postează pe un canal, deschide un tichet, actualizează o foaie de calcul, apelează un alt API. Platformele găzduite pe propriul server funcționează exact în același mod, atâta timp cât punctul de sfârșit poate fi accesat prin HTTPS.

CRM-uri și servicii de asistență

Trimiteți evenimentele de facturare și de cont către HubSpot, Pipedrive, Salesforce, sau către orice birou de asistență sau CRM cu un webhook de intrare, astfel încât înregistrarea unui client să reflecte ceea ce face găzduirea sa, fără ca nimeni să fie nevoit să o copieze manual.

Orice altceva care ascultă

Slack, Discord, Google Sheets, Airtable, Notion, propria voastră monitorizare, un data warehouse sau un mic script pe care l-ați scris. Dacă poate accepta un POST HTTPS și citi JSON, le poate recepționa.

Ce se trimite

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

Facturare și plăți

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

Site-uri și securitate

Implementarea s-a încheiat, un site este suspendat, s-a găsit malware, copii de rezervă și modificări ale certificatului.

Asistență și domenii

Tickete deschise și escalate, transferuri de domenii, reînnoiri și modificări DNS.

Demonstrarea faptului că o solicitare provine de la noi

Fiecare cerere este semnată cu un secret pe care doar tu și noi îl deținem. Verifică semnătura înainte de a acționa asupra conținutului — aceste antete 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

Marcajul de timp este semnat împreună cu corpul mesajului în loc să fie trimis alături de acesta, astfel încât o cerere interceptată de cineva să nu poată fi retrimisă către dumneavoastră mai târziu. Respingeți orice este mai vechi de câteva minute.

Cheia dumneavoastră de semnătură este afișată o singură dată, când adăugați webhook-ul. Nu o putem afișa din nou — dacă o pierdeți, eliminați destinația și adăugați-o din nou.

Configurarea uneia

  1. În panoul de control, deschideți Notificări și adăugați o destinație de tip Webhook.
  2. Introduceți adresa dumneavoastră HTTPS și copiați secretul de semnătură pe care vi-l afișăm.
  3. Apăsați Test. Trimitem o cerere reală în aceeași formă ca una live, astfel încât să o puteți testa înainte să se întâmple ceva real.
  4. Alegeți categoriile pe care ar trebui să le primească destinația respectivă. Noile tipuri de notificări sunt activate automat.

Poți adăuga câte destinații dorești, poți combina webhook-urile cu e-mailul, Slack și Telegram și poți atribui fiecăreia un set diferit de categorii.

Preferați să ne sunați în schimb?

Webhookurile vă spun când s-a întâmplat ceva. API-ul este modul în care faceți ca ceva să se întâmple — fiecare operațiune pe care o efectuează panoul de control vă stă la dispoziție.

Răsfoiește referința API