Webhooki pozwalają Smartsupp wysyłać powiadomienia w czasie rzeczywistym na dowolny wybrany przez Ciebie URL — gdy tylko rozmowa zostanie otwarta, kontakt zostanie utworzony lub wiadomość zostanie dostarczona, Twój system od razu o tym wie. Ten artykuł wyjaśnia, czym są webhooki, jak skonfigurować je w dashboardzie i jak połączyć je z platformami automatyzacji, takimi jak Make i n8n.
Podzieliliśmy artykuł na kilka sekcji:
Do czego służą webhooki?
Webhook to automatyczna wiadomość HTTP, którą Smartsupp wysyła na wybrany przez Ciebie URL za każdym razem, gdy wystąpi wybrane zdarzenie. Zamiast cyklicznie sprawdzać zmiany, Twoje narzędzia otrzymują dane natychmiast po wystąpieniu zdarzenia.
Typowe zastosowania obejmują:
Platformy automatyzacji — uruchamiaj scenariusze w Make, n8n lub podobnych narzędziach, aby dodawać kontakty do CRM, publikować powiadomienia w Slacku lub zapisywać leady w arkuszu kalkulacyjnym
Systemy wewnętrzne — przekazuj dane rozmów i kontaktów do dashboardów, hurtowni danych lub systemów obsługi zgłoszeń w czasie rzeczywistym
Powiadomienia — powiadamiaj swój zespół, gdy rozmowy zostaną ocenione lub gdy dostarczenie wiadomości się nie powiedzie
Wskazówka: Webhooki są dostępne w pakiecie Plus i wyższych pakietach — Plus obejmuje 1 webhook, Expert obejmuje 3, a Ultimate oferuje indywidualny limit. Porównaj pakiety →
Utwórz webhook
Konfiguracja webhooka w Twoim dashboardzie Smartsupp wymaga zaledwie kilku kroków:
1. Otwórz Ustawienia i przejdź do sekcji Webhooki .
2. Kliknij, aby dodać nowy webhook, i wpisz URL punktu końcowego — adres, na który Smartsupp będzie wysyłać dane zdarzeń.
3. Wybierz zdarzenia , które chcesz otrzymywać (pełną listę znajdziesz w następnej sekcji).
4. Zapisz webhook. Od tej chwili wybrane zdarzenia będą dostarczane jako żądania HTTP POST z danymi w formacie JSON.
Uwaga: Wcześniej skonfigurowane webhooki nadal działają normalnie. Trwają prace nad tym, aby wszystkie istniejące webhooki były widoczne i można było nimi zarządzać w nowej sekcji dashboardu.
⚠️ Masz już wcześniej utworzone webhooki? Starsze webhooki nie są jeszcze widoczne w tej sekcji — działają tak jak dotychczas. Łączymy stary i nowy system, aby można było zarządzać wszystkim w jednym miejscu.
Dostępne zdarzenia
Smartsupp może powiadamiać Twój punkt końcowy o zdarzeniach z trzech kategorii. Wybierz tylko te zdarzenia, których Twój scenariusz rzeczywiście potrzebuje — ograniczy to obciążenie punktu końcowego i pozwoli uniknąć zbędnego ruchu.
Kontakty
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Rozmowy
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Odwiedzający
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Powiązane materiały: Dokumentacja dla programistów Smartsupp — pełne schematy danych JSON dla każdego typu zdarzenia.
Przetestuj swój webhook
Przed uruchomieniem skorzystaj z wbudowanej funkcji testowania, aby sprawdzić, czy Twój punkt końcowy jest dostępny i czy Twój scenariusz w Make lub n8n jest poprawnie skonfigurowany.
W ustawieniach webhooka w dashboardzie kliknij Wyślij test. Smartsupp wyśle przykładowe dane na URL Twojego punktu końcowego. Sprawdź usługę odbierającą, aby potwierdzić, że dane dotarły w oczekiwanym formacie.
Wskazówka: W Make Twój scenariusz musi być aktywny i nasłuchiwać przed wysłaniem testu. W n8n przełącz węzeł Webhook na produkcyjny URL i upewnij się, że scenariusz jest aktywny.
Dostarczanie, ponowne próby i bezpieczeństwo
Smartsupp zaprojektowano tak, aby niezawodnie dostarczał zdarzenia webhooków, nawet gdy Twój punkt końcowy jest tymczasowo niedostępny.
Format — wszystkie zdarzenia są wysyłane jako żądania HTTP POST z treścią w formacie JSON opisującą zdarzenie i jego dane
Odpowiedź — Twój punkt końcowy powinien jak najszybciej odpowiedzieć kodem statusu HTTP 2xx; powolne odpowiedzi mogą opóźniać ponowne próby
Ponowne próby — jeśli dostarczenie się nie powiedzie, Smartsupp ponawia próby w coraz dłuższych odstępach przez maksymalnie 3 dni
Automatyczne wyłączanie — punkty końcowe, dla których dostarczanie stale kończy się niepowodzeniem, są automatycznie wyłączane; możesz je ponownie włączyć w dashboardzie w dowolnym momencie
Bezpieczeństwo — każde żądanie webhooka jest podpisane, dzięki czemu możesz zweryfikować, czy rzeczywiście pochodzi ze Smartsupp; odwiedź docs.smartsupp.com , aby poznać szczegóły weryfikacji podpisu
Uwaga: Jeśli Twój punkt końcowy zostanie wyłączony z powodu powtarzających się błędów, włącz go ponownie w Ustawienia → Webhooki po usunięciu przyczyny problemu. Smartsupp natychmiast wznowi wysyłanie zdarzeń.
Połącz Smartsupp z Make lub n8n
Połączenie Smartsupp z platformą automatyzacji wymaga czterech kroków. Proces jest taki sam dla Make i n8n — różni się tylko węzeł wyzwalacza.
1. W Make, dodaj wyzwalacz Webhooki → Niestandardowy webhook i skopiuj wygenerowany URL. W n8n, dodaj węzeł wyzwalacza Webhook i skopiuj jego produkcyjny URL.
2. W Smartsupp przejdź do Ustawienia → Webhooki, utwórz nowy webhook i wklej skopiowany URL.
3. Wybierz potrzebne zdarzenia i zapisz webhook.
4. Kliknij Wyślij test , aby Make lub n8n przechwycił strukturę danych — następnie na jej podstawie zbuduj resztę swojego scenariusza lub procesu.
Wskazówka: W Make aktywuj swój scenariusz przed wysłaniem testu — w przeciwnym razie dane webhooka nie zostaną przechwycone. W n8n użyj produkcyjnego URL (nie testowego URL) podczas konfigurowania webhooka Smartsupp.
Co dalej?
Smartsupp REST API — poznaj pełne API, aby programowo odczytywać i zapisywać dane Smartsupp.
Automatyzacje — skonfiguruj automatyzacje oparte na regułach, które uruchamiają się bezpośrednio w Smartsupp bez zewnętrznego narzędzia.
Przegląd integracji — zobacz wszystkie dostępne natywne integracje z systemami CRM, platformami e-commerce i innymi narzędziami.
💡 Potrzebujesz więcej pomocy? Skontaktuj się z naszym Zespołem wsparcia — chętnie pomożemy!