Subskrypcje webhooków w Livespace CRM pozwalają Twojej aplikacji otrzymywać informacje w czasie rzeczywistym o ważnych wydarzeniach w systemie: na przykład utworzenie nowej szansy sprzedaży lub zmiana jej statusu. Dzięki temu możesz łatwo integrować Livespace z innymi narzędziami lub automatyzować swoje procesy.
W tym artykule:
Ważne pojęcia
W Livespace rozróżniamy dwa pojęcia: subskrypcję webhooka oraz webhook.
Subskrypcja webhooka to konfiguracja, w której określasz:
kiedy mają być wysyłane dane (jakie zdarzenia),
dokąd mają być wysyłane (adres URL),
jakie informacje mają być przekazywane.
Webhook to pojedynczy komunikat wysyłany przez Livespace w momencie wystąpienia zdarzenia, zgodnie z ustawieniami subskrypcji.
Pamiętaj, że subskrypcja definiuje zasady wysyłania, a webhook jest wysyłaną wiadomością.
Jak działają webhooki?
Webhooki działają w prosty sposób: gdy coś ważnego wydarzy się w Livespace, system wysyła webhook ( czyli komunikat) do wskazanego adresu URL, zgodnie z konfiguracją subskrypcji.
Każde powiadomienie zawiera:
informacje o zdarzeniu (np. ID transakcji, status, właściciele, wartość, produkty),
nagłówek do weryfikacji autentyczności,
specjalny secret (tajny klucz), który zapewnia bezpieczeństwo.
Po zapisaniu i aktywacji subskrypcji, Livespace najpierw wysyła testowe powiadomienie do Twojego punktu końcowego, aby upewnić się, że jest on poprawnie skonfigurowany i gotowy do odbierania danych. Dopiero potem wysyłane są właściwe webhooki dla rzeczywistych zdarzeń.
Dokumentację techniczną znajdziesz tutaj:
Przegląd webhooków w Livespace
Administratorzy mogą zarządzać subskrypcjami webhooków w Ustawienia konta -> Webhooki.
Na liście subskrypcji sprawdzisz:
czy subskrypcja jest aktywna,
jej nazwę i adres URL,
wybrane zdarzenia,
ostatni czas wywołania.
Możesz też:
z pomocą suwaka aktywować lub dezaktywować subskypcję,
edytować jej dane,
podejrzeć secret,
usuwać wybrane subskrypcje.
Tworzenie nowej subskrypcji
Aby Livespace mógł wysyłać webhooki do Twojej aplikacji lub narzędzia zewnętrznego, musisz utworzyć i skonfigurować subskrypcję webhooka.
Webhook może wysyłać dane do dowolnego narzędzia lub systemu, który obsługuje odbieranie webhooków. Może to być zarówno gotowe narzędzie integracyjne, jak i Twoje własne API.
W Ustawienia konta -> Webhooks wybierz Dodaj subskrypcję.
2. W sekcji Połącz podaj podstawowe informacje:
Nazwij tę subskrypcję – nadaj nazwę, którą później łatwo rozpoznasz.
Dokąd mamy wysyłać dane? – wklej adres URL punktu końcowego webhooka.
3. Następnie kliknij Dalej:Ustaw wyzwalacze.
4. Wybierz zdarzenie, w którym Livespace ma wysyłać dane.
5. Następnie kliknij Aktywuj subskrypcję.
W tym momencie Twoja subskrypcja jest aktywna – w przykładzie powyżej webhooki będą wysyłane w momencie utworzenia szansy sprzedaży.
Jeśli dodasz w Livespace nową szansę sprzedaży, zewnętrzne narzędzie otrzyma informacje na ten temat.
Przykładowe odebranie danych w Zapier:
Pamiętaj, że pierwsze zapytanie to testowe powiadomienie do Twojego punktu końcowego, aby upewnić się, że jest ono poprawnie skonfigurowane.
Co zawiera powiadomienie? Docelowe powiadomienie zawiera najważniejsze informacje o szansie sprzedaży: ID, nazwa, status, właściciele, wartość, produkty, koszty i tagi.
Skąd wziąć adres webhooka?
Adres webhooka (URL punktu końcowego) generowany jest przez narzędzie lub system, który ma odbierać powiadomienia z Livespace.
Poniżej znajdziesz instrukcje dla najczęściej używanych narzędzi.
Zapier
Przejdź do sekcji Zaps.
Kliknij Create i wybierz New Zap.
Kliknij blok Trigger.
Z listy aplikacji wybierz Webhooks.
Wybierz zdarzenie Catch Hook.
Przejdź do zakładki Test.
Skopiuj wygenerowany adres URL webhooka.
Przykładowa konfiguracja w Zapier:
Make
Przejdź do sekcji Scenarios.
Kliknij Create a new scenario.
Wybierz moduł Webhooks -> Custom webhook.
Dodaj nowy webhook lub wybierz istniejący.
Skopiuj wygenerowany adres URL.
N8N
Wybierz Create workflow.
Kliknij Add first step… i wybierz On webhook call.
Skopiuj Test URL lub Production URL:
Test URL służy do testów,
Production URL może zostać użyty dopiero po opublikowaniu workflow.
Bezpieczeństwo i działanie
Wszystkie dane wysyłane przez webhooki przesyłane są wyłącznie przez szyfrowane połączenie HTTPS. Dzięki temu informacje są chronione podczas przesyłania w sieci.
Każde powiadomienie zawiera specjalny specjalny nagłówek weryfikacyjny, tworzony na podstawie sekretu subskrypcji. Pozwala on sprawdzić, że dane pochodzą rzeczywiście od Livespace, a nie od osoby trzeciej. Jest to dodatkowe zabezpieczenie, które zwiększa bezpieczeństwo integracji.
Jeżeli Twój punkt końcowy (adres, na który wysyłamy webhooki) nie odpowiada prawidłowo, Livespace automatycznie próbuje dostarczyć powiadomienie jeszcze dwa razy w krótkich odstępach czasu.
Webhooki działają w taki sposób, że:
to samo zdarzenie może zostać wysłane więcej niż raz,
zdarzenia mogą docierać w innym niż rzeczywisty porządku.
Dlatego Twoja aplikacja powinna być na to przygotowana – np. sprawdzać unikalne identyfikatory zdarzeń i odpowiednio reagować, aby nie powielać operacji.
Więcej informacji na temat bezpieczeństwa znajdziesz tutaj:
Dobre praktyki
Twój punkt końcowy powinien szybko odpowiadać.
Jeśli spodziewasz się dużej liczby powiadomień, używaj kolejek lub dodatkowych serwerów.
Monitoruj punkt końcowy, żeby upewnić się, że powiadomienia są odbierane.
Co zrobić gdy webhook nie działa?
Problemy z webhookami najczęściej wynikają z nieprawidłowej konfiguracji subskrypcji lub niedostępnego punktu końcowego. Jeżeli webhook nie działa:
Sprawdź adres URL:
Upewnij się, że adres URL zaczyna się od https://
Jeśli używasz narzędzi zewnętrznych (np. Zapier, Make), sprawdź, czy skopiowano poprawny URL z ich platformy.
Sprawdź punkt końcowy:
Livespace wysyła testowe powiadomienie po aktywacji subskrypcji.
Twój punkt końcowy musi odpowiedzieć status 200 OK lub 204 No Content w ciągu 3 sekund.
Jeśli nie odpowiada - sprawdź konfigurację serwera.
Sprawdź wybrane zdarzenia:
Upewnij się, że w subskrypcji zostały wybrane odpowiednie zdarzenia.
Jeśli webhook był wcześniej skonfigurowany (np. w Zapierze), a następnie próbujesz utworzyć identyczną subskrypcję na innym koncie Zapier lub dla innego użytkownika, webhook może nie zostać poprawnie utworzony.
Testuj i monitoruj:
Testuj odbiór webhooków przy użyciu narzędzi takich jak Zapier, Make lub własnego testowego endpointu.
Monitoruj logi po stronie odbiorcy, aby sprawdzić, czy powiadomienia docierają i są poprawnie przetwarzane.
Jeśli po sprawdzeniu powyższych punktów webhook nadal nie działa, skontaktuj się z supportem Livespace: pomożemy Ci znaleźć przyczynę i uruchomić powiadomienia.
Obsługiwane zdarzenia
Aktualnie Livespace obsługuje:
Zdarzenie | Co oznacza? |
| Wyzwalane, gdy tworzona jest nowa szansa sprzedaży |
| Wyzwalane, gdy zmienia się status szansy sprzedaży |