Programiści

Webhooki

Każde powiadomienie wygenerowane przez Państwa konto może zostać przesłane bezpośrednio do Państwa systemów jako podpisane żądanie JSON POST — dzięki temu zdarzenia na Państwa hostingu mogą inicjować przepływy pracy w dowolnym innym miejscu.

Cała dokumentacja dla programistów →

Z czym można to połączyć

Webhook to zwykłe żądanie HTTPS, więc wszystko, co może je odebrać, może podjąć odpowiednie działanie. Nie potrzebują Państwo naszej pomocy, aby stworzyć integrację dla swojego narzędzia.

Platformy automatyzacji

Skieruj webhook na przepływ pracy w n8n, Make, Zapier, Pipedream, Activepieces, a każde zdarzenie stanie się wyzwalaczem — publikuj na kanale, otwieraj zgłoszenia, aktualizuj arkusze kalkulacyjne, wywołuj inne API. Platformy hostowane samodzielnie działają dokładnie w ten sam sposób, o ile punkt końcowy jest dostępny przez HTTPS.

Systemy CRM i helpdeski

Wysyłaj zdarzenia rozliczeniowe i dotyczące konta do HubSpot, Pipedrive, Salesforce lub do dowolnego systemu pomocy technicznej lub CRM z obsługą przychodzących webhooków, aby kartoteka klienta odzwierciedlała stan hostingu bez konieczności ręcznego kopiowania danych.

Wszystko inne, co nasłuchuje

Slack, Discord, Google Sheets, Airtable, Notion, Państwa własny monitoring, hurtownia danych lub mały skrypt napisany przez Państwa. Jeśli potrafi zaakceptować żądanie HTTPS POST i odczytać JSON, może to odbierać.

Co jest wysyłane

Mogą Państwo wybrać, które kategorie trafiają do którego miejsca docelowego — można też połączyć kilka, dzięki czemu rozliczenia trafią w jedno miejsce, a powiadomienia witryny w inne. Domyślnie wszystko jest włączone.

Rozliczenia i płatności

Faktury wystawione i opłacone, nieudane płatności, karty, których ważność wkrótce wygaśnie, odnowienia i anulowania.

Witryny i bezpieczeństwo

Aprowizacja zakończona, witryna zawieszona, wykryto złośliwe oprogramowanie, kopie zapasowe i zmiany certyfikatów.

Pomoc techniczna i domeny

Otwarte i eskalowane zgłoszenia, transfery domen, odnowienia oraz zmiany DNS.

Potwierdzenie, że żądanie pochodzi od nas

Każde żądanie jest podpisane sekretem, który posiadają tylko Państwo i my. Przed podjęciem działań na treści należy sprawdzić podpis — te nagłówki są dołączane do każdego doręczenia:

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

Znacznik czasu jest podpisywany razem z treścią, a nie wysyłany obok niej, dzięki czemu przechwycone żądanie nie może zostać później ponownie odtworzone przeciwko Państwu. Należy odrzucać wszystko, co jest starsze niż kilka minut.

Twój klucz tajny do podpisywania jest wyświetlany tylko raz, podczas dodawania webhooka. Nie możemy wyświetlić go ponownie — jeśli go zgubisz, usuń punkt docelowy i dodaj go ponownie.

Konfigurowanie

W panelu nawigacyjnym otwórz Powiadomienia i dodaj miejsce docelowe typu Webhook.
Podaj swój punkt końcowy HTTPS i skopiuj wyświetlony klucz tajny podpisywania.
Proszę nacisnąć Test. Wysyłamy rzeczywiste żądanie w takiej samej postaci jak żądanie produkcyjne, aby można było na nim bazować, zanim cokolwiek wydarzy się naprawdę.
Wybierz, które kategorie ma odbierać to miejsce docelowe. Nowe rodzaje powiadomień są włączane automatycznie.

Mogą Państwo dodać dowolną liczbę miejsc docelowych, łączyć webhooki z pocztą e-mail, Slack i Telegram oraz przypisać do każdego z nich inny zestaw kategorii.

Wolisz raczej do nas zadzwonić?

Webhooki informują o zaistnieniu danego zdarzenia. API to sposób na wywołanie określonego działania — każda operacja wykonywana przez panel nawigacyjny jest do Państwa dyspozycji.

Przeglądaj dokumentację API