Webhooks pozwalają Smartsupp na wysyłanie powiadomień w czasie rzeczywistym na dowolny wybrany adres URL — w momencie otwarcia rozmowy, utworzenia kontaktu lub dostarczenia wiadomości Twój system natychmiast o tym wie. Ten artykuł wyjaśnia, czym są webhooks, jak je skonfigurować w panelu i jak połączyć z platformami automatyzacji, takimi jak Make i n8n.
Podzieliliśmy artykuł na kilka sekcji:
Do czego służą webhooks?
Webhook to automatyczna wiadomość HTTP, którą Smartsupp wysyła na wybrany adres URL za każdym razem, gdy wystąpi wybrane zdarzenie. Zamiast odpytywać o zmiany, Twoje narzędzia otrzymują dane w momencie, gdy coś się dzieje.
Typowe przypadki użycia to:
Platformy automatyzacji — wyzwalanie przepływów pracy w Make, n8n lub podobnych narzędziach w celu dodawania kontaktów do CRM, wysyłania powiadomień do Slacka lub rejestrowania leadów w arkuszu kalkulacyjnym
Systemy wewnętrzne — przesyłanie danych rozmów i kontaktów do pulpitów nawigacyjnych, hurtowni danych lub systemów zgłoszeń w czasie rzeczywistym
Powiadomienia — alerty dla zespołu, gdy rozmowy są oceniane lub gdy dostarczenie wiadomości nie powiedzie się
Wskazówka: Webhooks są dostępne w planie Plus i wyższych — Plus obejmuje 1 webhook, Expert 3, a Ultimate oferuje niestandardowy limit. Porównaj plany →
Tworzenie webhooka
Konfiguracja webhooka wymaga tylko kilku kroków w panelu Smartsupp:
1. Otwórz Ustawienia i przejdź do sekcji Webhooks.
2. Kliknij, aby dodać nowego webhooka i wpisz swój adres URL endpointu — adres, na który Smartsupp będzie wysyłać dane zdarzeń.
3. Wybierz zdarzenia, które chcesz otrzymywać (pełna lista w następnej sekcji).
4. Zapisz webhooka. Od tej chwili wybrane zdarzenia są dostarczane jako żądania HTTP POST z payloadami JSON.
Uwaga: Wcześniej skonfigurowane webhooks nadal działają normalnie. Trwają prace nad udostępnieniem wszystkich istniejących webhooków w nowej sekcji panelu.
Dostępne zdarzenia
Smartsupp może powiadamiać Twój endpoint o zdarzeniach w trzech kategoriach. Wybierz tylko te zdarzenia, których Twój przepływ pracy rzeczywiście potrzebuje — dzięki temu endpoint pozostaje lekki i unika się 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 zasoby: Dokumentacja dla deweloperów Smartsupp — pełne schematy payload JSON dla każdego typu zdarzenia.
Testowanie webhooka
Przed uruchomieniem na żywo użyj wbudowanej funkcji testowej, aby sprawdzić, czy Twój endpoint jest osiągalny i czy Twój scenariusz Make lub n8n jest poprawnie skonfigurowany.
W ustawieniach webhooków w panelu kliknij Wyślij test. Smartsupp wyśle przykładowy payload na adres URL Twojego endpointu. 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 jego produkcyjny adres URL i upewnij się, że przepływ pracy jest aktywny.
Dostarczanie, ponowne próby i bezpieczeństwo
Smartsupp jest zaprojektowany do niezawodnego dostarczania zdarzeń webhook, nawet gdy Twój endpoint jest tymczasowo niedostępny.
Format — wszystkie zdarzenia są wysyłane jako żądania HTTP POST z treścią JSON opisującą zdarzenie i jego dane
Odpowiedź — Twój endpoint powinien jak najszybciej odpowiedzieć kodem statusu HTTP 2xx; powolne odpowiedzi mogą opóźnić ponowne próby
Ponowne próby — jeśli dostarczenie nie powiedzie się, Smartsupp ponawia próby z rosnącymi opóźnieniami przez maksymalnie 3 dni
Automatyczne wyłączenie — endpointy, które stale zawodzą, są automatycznie wyłączane; możesz je ponownie włączyć w panelu w dowolnym momencie
Bezpieczeństwo — każde żądanie webhook jest podpisane, dzięki czemu możesz zweryfikować, że rzeczywiście pochodzi od Smartsupp; szczegóły weryfikacji podpisu znajdziesz na docs.smartsupp.com
Uwaga: Jeśli Twój endpoint jest wyłączony z powodu powtarzających się błędów, włącz go ponownie w Ustawienia → Webhooks po usunięciu podstawowego 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ł wyzwalający.
1. W Make dodaj wyzwalacz Webhooks → Niestandardowy webhook i skopiuj wygenerowany adres URL. W n8n dodaj węzeł wyzwalający Webhook i skopiuj jego produkcyjny adres URL.
2. W Smartsupp przejdź do Ustawienia → Webhooks, utwórz nowego webhooka i wklej skopiowany adres URL.
3. Wybierz potrzebne zdarzenia i zapisz webhooka.
4. Kliknij Wyślij test, aby Make lub n8n przechwycił strukturę danych — następnie zbuduj resztę scenariusza lub przepływu pracy na tej podstawie.
Wskazówka: W Make aktywuj scenariusz przed wysłaniem testu — w przeciwnym razie dane webhooka nie zostaną przechwycone. W n8n użyj produkcyjnego adresu URL (nie testowego) podczas konfigurowania webhooka Smartsupp.
Co dalej?
Smartsupp REST API — poznaj pełne API do programowego odczytywania i zapisywania danych Smartsupp.
Automatyzacje — skonfiguruj automatyzacje oparte na regułach, które są wyzwalane bezpośrednio w Smartsupp bez zewnętrznego narzędzia.
Przegląd integracji — zobacz wszystkie dostępne natywne integracje z CRM, platformami e-commerce i innymi.
💡 Potrzebujesz dodatkowej pomocy? Skontaktuj się z naszym zespołem wsparcia — chętnie pomożemy!