Wykorzystanie webhooków w przepływach pracy HubSpot

Używaj webhooków w przepływach pracy, aby wysyłać żądania POST lub GET ze swoich przepływów pracy. Istnieje wiele różnych zastosowań webhooków, przykłady popularnych przypadków użycia webhooków obejmują:

• Przesyłanie danych kontaktów z HubSpot do innego systemu, np. CRM, gdy dany kontakt wypełni określony formularz w witrynie.

• Wysyłanie danych transakcji do zewnętrznego systemu obsługi przesyłek w celu utworzenia zamówienia zakupu.

• Wysyłanie alertów czatu z systemu zewnętrznego do firmowego strumienia czatu, aby powiadomić pracowników, że wydarzyło się coś ważnego.

• Pobieranie danych z innego systemu w celu aktualizacji rekordów HubSpot.

HubSpot reguluje ruch webhooków oddzielnie od innych procesów przepływu pracy. Ma to na celu usprawnienie przepływu pracy i wydajności webhooków. W przypadku powolnego działania webhooka lub przekroczenia limitu czasu, wykonanie akcji przepływu może trwać dłużej niż oczekiwano.

Uwaga: HubSpot będzie ponawiał próby uruchomienia nieudanych webhooków przez okres do trzech dni, począwszy od jednej minuty po niepowodzeniu. Kolejne niepowodzenia będą ponawiane w coraz większych odstępach czasu, z maksymalnym odstępem ośmiu godzin pomiędzy próbami. Informacje na temat wyjątków określonych kodów błędów można znaleźć w dokumentacji dla programistów firmy HubSpot.

Więcej informacji na temat webhooków można znaleźć w dokumentacji dla programistów dotyczącej webhooków. Jeśli masz pytania dotyczące konkretnej implementacji webhooków z HubSpot, skontaktuj się z HubSpot Developers Forums.

Skonfiguruj webhook w swoim przepływie pracy

• W koncie HubSpot przejdź do Automatyzacja > Przepływy pracy.
• Kliknijnazwę przepływu pracy.
• Kliknąć ikonę +, aby dodać akcję.
• W prawym panelu należy wybrać opcjęWyślij webhook.
• Kliknij menu rozwijane Metoda, a następnie wybierz POST lub GET.
• Wprowadź adres URL webhooka. Adresy URL webhooków są ograniczone do bezpiecznego protokołu i muszą zaczynać się od HTTPS. Aby zażądać określonych informacji, dodaj parametry zapytania do adresu URL Webhook. Jeśli nie zostaną dodane żadne parametry zapytania, zostanie wysłane ogólne żądanie POST lub GET.
• Aby uwierzytelnić wszelkie żądania do Twojego webhooka:
  • Kliknij menu rozwijane Typ uwierzytelniania, a następnie wybierz opcję Uwzględnij podpis żądania w nagłówku.
  • Wprowadź swój identyfikator HubSpot App ID. Dowiedz się, jakzweryfikować podpisy żądań.
• Kliknij przycisk Zapisz.
  
  

Przetestuj swój webhook w HubSpot

Po skonfigurowaniu webhooka POST lub GET możesz wykonać test, aby wyświetlić odpowiedź webhooka. Podczas testu, gdy dane są wysyłane do i pobierane od strony trzeciej, istniejące rekordy w HubSpot nie zostaną naruszone.

Po przetestowaniu swojego webhooka, możeszwybrać pola, które mają być wyprowadzane, aby mogły być użyte jako dane wejściowe w dalszej części przepływu pracy. Wybierz tylko dane wyjściowe dostępne w każdej odpowiedzi. Jeśli dane wyjściowe zostaną użyte w późniejszej akcji, ale nie będą dostępne w odpowiedzi, akcja nie powiedzie się.

• W panelu bocznym kliknij przycisk Testuj akcję, aby rozwinąć tę sekcję.
• Kliknij menu rozwijane Obiekt, a następnie wybierz Rekord do testowania.
• Kliknij Testuj.
• Aby sprawdzić szczegóły webhooka, wybierz zakładkę Odpowiedź lub Żądanie. Na każdej karcie można kliknąć Otwórz wszystko, aby rozwinąć wszystkie sekcje lub Zwiń wszystko, aby zwinąć wszystkie sekcje.
  
  • W zakładce Odpowiedź, kliknij Nagłówki: lub Treść: aby rozwinąć każdą sekcję.
  • W zakładce Żądanie kliknij httpHeaders: , aby rozwinąć sekcję.
    
    

Zewnętrzne testowanie webhooka

Po utworzeniu przepływu pracy z akcją webhooka, można przeprowadzić szybki test z wykorzystaniem fikcyjnego adresu URL webhooka:

• W przeglądarce internetowej należy przejść na stronę https://webhook.site i skopiować unikalny adres URL.
• W polu Webhook URL w swojej akcji webhook, wklej adres URL.
  
  

• Po włączeniu przepływu, można ręcznie zapisać kontakt testowy.

Jeśli wywołana zostanie akcja webhooka z żądaniem POST, do webhooka wysłana zostanie odpowiedź JSON, zawierająca wszystkie informacje o kontakcie, w tym przesłane formularze, przynależność do listy oraz wszystkie wartości właściwości kontaktu. System odbierający może następnie przetworzyć dane JSON i wykorzystać je w swojej własnej aplikacji.

Jeśli zostanie wyzwolona akcja webhook z żądaniem GET, zostanie wysłane ogólne żądanie GET, chyba że zastosowano dodatkowe parametry zapytania.

Uwaga: historyczne wartości właściwości będą zwracane tylko w przepływach pracy opartych na kontaktach. Webhooki używane we wszystkich innych typach przepływów zwrócą jedynie najbardziej aktualną wartość.

Weryfikacja sygnatur żądań w webhookach przepływów pracy

W przypadku wybrania opcji Podpis żądania w sekcjiUwierzytelnianie dla akcjiWyzwalanie web hooka, HubSpot wypełni webhook nagłówkiem X-HubSpot-Signature, zawierającym skrót SHA-256 konkatenacji app-secret aplikacji, metody HTTP, URI oraz niesparsowanego ciała. Dowiedz się więcej na ten temat wdokumentacji dla programistów.

Aby sprawdzić, czy żądania otrzymywane pod Twoim adresem URL pochodzą z HubSpot:

• Posiadaj konto dewelopera. Jeśli jeszcze go nie posiadasz, załóż konto programisty.
• Posiadać aplikację. Jeśli nie masz aplikacji, dowiedz się, jak ją stworzyć.
• Sprawdź wartość hash podpisu.