Przejdź do treści
Uwaga: Tłumaczenie tego artykułu jest podane wyłącznie dla wygody. Tłumaczenie jest tworzone automatycznie za pomocą oprogramowania tłumaczącego i mogło nie zostać sprawdzone. W związku z tym, angielska wersja tego artykułu powinna być uważana za wersję obowiązującą, zawierającą najnowsze informacje. Możesz uzyskać do niej dostęp tutaj.
Workflows

Wykorzystanie webhooków w przepływach pracy HubSpot

Data ostatniej aktualizacji: lutego 28, 2022

Dotyczy:

Operations Hub Professional

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.

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:

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.