Fejlesztők

Webhookok

A fiókja által létrehozott minden értesítés közvetlenül elküldhető a saját rendszereibe aláírt JSON POST kérésként — így a tárhelyén történő események bárhol máshol munkafolyamatot indíthatnak el.

Minden fejlesztői dokumentáció →

Amihez csatlakoztathatja

A webhook egy közönséges HTTPS-kérés, így bármi, ami képes ilyet fogadni, reagálhat is rá. Nincs szüksége arra, hogy integrációt építsünk az Ön eszközéhez.

Automatizálási platformok

Irányítson egy webhookot a(z) n8n, Make, Zapier, Pipedream, Activepieces egyik munkafolyamatára, és minden esemény kiváltó okká válik — tegyen közzé bejegyzést egy csatornán, nyisson meg egy jegyet, frissítsen egy táblázatot, hívjon meg egy másik API-t. A saját üzemeltetésű platformok pontosan ugyanígy működnek, amennyiben a végpont elérhető HTTPS-en keresztül.

CRM-ek és ügyfélszolgálatok

Küldje a számlázási és fiókeseményeket a(z) HubSpot, Pipedrive, Salesforce platformra, vagy bármely bejövő webhookkal rendelkező ügyfélszolgálati rendszerbe vagy CRM-be, hogy az ügyfélrekord pontosan tükrözze a tárhely állapotát anélkül, hogy bárkinek manuálisan kellene másolnia az adatokat.

Bármi más, ami figyel

Slack, Discord, Google Sheets, Airtable, Notion, a saját monitorozása, egy adattárház vagy egy kis parancsfájl, amelyet Ön írt. Ha képes fogadni a HTTPS POST kérést és olvasni a JSON-t, akkor képes ezeket fogadni.

Mi kerül elküldésre

Ön választja ki, hogy mely kategóriák melyik célhelyre kerüljenek — és többet is összekapcsolhat, így a számlázás az egyik helyre, a webhelyértesítések pedig egy másikra mehetnek. Alapértelmezés szerint minden be van kapcsolva.

Számlázás és fizetések

Kiállított és kifizetett számlák, sikertelen fizetések, hamarosan lejáró kártyák, megújítások és lemondások.

Webhelyek és biztonság

A kiépítés befejeződött, egy webhely felfüggesztve, kártevő észlelve, biztonsági mentések és tanúsítványmódosítások.

Támogatás és domainek

Megnyitott és eszkalált hibajegyek, doménátregisztrációk, megújítások és DNS-módosítások.

Annak igazolása, hogy a kérés tőlünk érkezett

Minden kérést egy olyan titkos kulcs ír alá, amellyel csak Ön és mi rendelkezünk. Mielőtt feldolgozná a törzset, ellenőrizze az aláírást — ezek a fejlécek minden kézbesítéssel megérkeznek:

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

Az időbélyegző a törzzsel együtt kerül aláírásra ahelyett, hogy mellette küldenék el, így az elcsípett kérést később nem lehet újra felhasználni Ön ellen. Utasítson el mindent, ami néhány percnél régebbi.

Az aláírási titkát csak egyszer mutatjuk meg, amikor hozzáadja a webhookot. Nem tudjuk újra megjeleníteni — ha elveszíti, távolítsa el a célt, majd adja hozzá újra.

Beállítás folyamatban

  1. A vezérlőpultján nyissa meg az Értesítések menüpontot, és adjon hozzá egy Webhook típusú célhelyet.
  2. Adja meg HTTPS-végpontját, és másolja ki a megjelenített aláírási titkot.
  3. Nyomja meg a Test gombot. Egy valós kérést küldünk ugyanolyan formátumban, mint egy éles kérés, így építhet rá, mielőtt bármi éles történne.
  4. Válassza ki, hogy az adott célhely mely kategóriákat fogadja. Az új típusú értesítések automatikusan bekapcsolódnak.

Tetszőleges számú célhelyet adhat hozzá, kombinálhatja a webhookokat e-maillel, Slack és Telegram szolgáltatásokkal, és mindegyikhez eltérő kategóriakészletet rendelhet.

Inkább felhívna minket?

A webhookok értesítik Önt, ha valami történt. Az API segítségével Ön kezdeményezheti a történéseket — a vezérlőpult által végrehajtott minden művelet az Ön rendelkezésére áll.

Böngésszen az API-referenciában