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 z przepływami pracy w HubSpot

Data ostatniej aktualizacji: sierpnia 22, 2022

Dotyczy:

Operations Hub Professional

Użyj webhooków w przepływach pracy, aby wysyłać lub pobierać informacje między HubSpot i innymi zewnętrznymi narzędziami. Istnieje wiele zastosowań dla webhooków, przykłady popularnych przypadków użycia webhooków obejmują:

  • Publikowanie danych kontaktów HubSpot do innego systemu, takiego jak CRM, gdy ten kontakt wypełni określony formularz w Twojej witrynie.

  • Wysyłanie danych o 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 coś ważnego się wydarzyło.

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

Za pomocą przepływów pracy można wysyłać zarówno żądania POST, jak i GET. 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. Jeśli webhook działa wolno lub kończy się czasowo, wykonanie akcji przepływu może trwać dłużej niż oczekiwano.

Uwaga: HubSpot będzie ponawiał próby wykonania nieudanych webhooków przez maksymalnie trzy dni, zaczynając od jednej minuty po niepow odzeniu. Kolejne niepowodzenia będą sprawdzane w coraz większych odstępach czasu, przy czym maksymalna przerwa między próbami może wynosić osiem godzin. Dowiedz się o konkretnych wyjątkach kodu błędu w dokumentacji dla programistów firmy HubSpot.

Dowiedz się więcej o webhookach w dokumentacji deweloperskiej webhooków. Jeśli masz pytania dotyczące konkretnej implementacji webhooków z HubSpot, dotrzyj na fora deweloperów HubSpot.

Skonfiguruj webhook w swoim przepływie pracy

  • W koncie HubSpot przejdź do Automatyzacja > Przepływy pracy.
  • Kliknij nazwę przepływu pracy.
  • Kliknij ikonę +, aby dodać akcję.
  • W prawym panelu wybierz opcję Wyślij webhook.
  • Kliknij menu rozwijane Method, 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, można dodać parametry zapytania, takie jak ?queryparameter=abc do adresu URL Webhook. Jeśli nie dodano żadnych parametrów zapytania, zostanie wysłane ogólne żądanie POST lub GET.
  • Skonfiguruj typ uwierzytelniania, aby uwierzytelnić żądania do swojego webhooka:
    • Aby użyć podpisu żądania w swoim nagłówku webhook:
      • Kliknij menu rozwijane Authentication type. Następnie wybierz opcję Dołącz podpis żądania w nagłówku.
      • Następnie wprowadź swój HubSpot App ID. Dowiedz się, jakzweryfikować podpisy żądań.
    • Możesz również użyć klucza API do uwierzytelniania. Podczas używania klucza API do uwierzytelniania, nazwa klucza API i lokalizacja klucza API używane są zależne od tego, jak skonfigurowany jest webhook. Ze względów bezpieczeństwa klucz API nie będzie wyświetlany w żadnych żądaniach testowych. Aby użyć klucza API:
      • Kliknij menu rozwijane Typ uwie rzytelniania. Następnie wybierz opcję Klucz API.
      • Wprowadź nazwę swojego klucza API.
      • Kliknij menu rozwijane Lokalizacja klucza API. Następnie wybierz opcję Parametry zapytania lub Nagłówek żądania. Dowiedz się więcej o używaniu kluczy API w HubSpot.
  • Jeśli ustawiasz żądanie POST, możesz wybrać, aby dołączyć wszystkie właściwości z rekordu CRM lub wysłać tylko określone właściwości:
    • Aby uwzględnić wszystkie właściwości, w sekcji Dostosuj treść żądania wybierz opcję Uwzględnij wszystkie właściwości.
    • Aby uwzględnić tylko określone właściwości:
      • W sekcji Customize request body wybierz opcję Choose specific properties.
      • Kliknij menu rozwijane Wybierz właściw ość. Następnie kliknij [obiekt] w tym przepływie pracy i wybierz właściwość.
      • Aby zmienić nazwę właściwości w webhooku, edytuj pole tekstowe Nazwa właściwości. Spowoduje to tylko aktualizację nazwy właściwości w żądaniu POST, nie zaktualizuje nazwy właściwości ani nazwy wewnętrznej w HubSpot.
      • Aby dodać kolejną właściwość, kliknij przycisk Dodaj właściwość.
      • Aby usunąć właściwość, kliknij ikonę kosza na śmieci z napisem Usuń
        .


  • Jeśli konfigurujesz żądanie GET, możesz użyć właściwości jako parametrów zapytania:
    • W sekcji Parametry zapytania kliknij menu rozwijane Wybierz właściw ość. Następnie kliknij [obiekt] w tym przepływie pracy i wybierz właściwość.
    • Aby zmienić nazwę właściwości w parametrze zapytania, edytuj pole tekstowe Nazwa właściwości. Spowoduje to tylko aktualizację nazwy właściwości w żądaniu GET, nie zaktualizuje nazwy właściwości ani nazwy wewnętrznej w HubSpot.
    • Aby dodać kolejną właściwość, kliknij przycisk Dodaj parametr zapytania.
    • Aby usunąć właściwość, kliknij ikonę kosza na śmieci z napisem Usuń.
  • Kliknij przycisk Zapisz.



Dostosowywanie żądania POST

Jeśli konfigurujesz żądanie POST, możesz wybrać, aby uwzględnić wszystkie właściwości z rekordu CRM lub wysłać tylko określone właściwości:

  • Aby uwzględnić wszystkie właściwości, w sekcji Customize request body wybierz opcję Include all properties.
  • Aby uwzględnić tylko określone właściwości:
    • W sekcji Customize request body wybierz opcję Choose specific properties.
    • Kliknij menu rozwijane Wybierz właściw ość. Następnie kliknij [obiekt] w tym przepływie pracy i wybierz właściwość.
    • Aby zmienić nazwę właściwości w webhooku, edytuj pole tekstowe Nazwa właściwości. Spowoduje to tylko aktualizację nazwy właściwości w żądaniu POST, nie zaktualizuje nazwy właściwości ani nazwy wewnętrznej w HubSpot.
    • Aby dodać kolejną właściwość, kliknij przycisk Dodaj właściwość.
    • Aby usunąć właściwość, kliknij ikonę kosza na śmieci z napisem Usuń
      .


Dostosowywanie żądań GET

Jeśli konfigurujesz żądanie GET, możesz użyć właściwości jako parametrów zapytania, aby pobrać określone dane:

  • W sekcji Parametry zapytania kliknij menu rozwijane Wybierz właściw ość. Następnie kliknij [obiekt] w tym przepływie pracy i wybierz właściwość.
  • Aby zmienić nazwę właściwości w parametrze zapytania, należy edytować pole tekstowe Nazwa właściwości. Spowoduje to tylko aktualizację nazwy właściwości w żądaniu GET, nie zaktualizuje nazwy właściwości ani nazwy wewnętrznej w HubSpot.
  • Aby dodać kolejną właściwość, kliknij przycisk Dodaj parametr zapytania.
  • Aby usunąć właściwość, kliknij ikonę kosza na śmieci z usunięciem.
  • Kliknij Zapisz.

Przetestuj swój webhook w HubSpot

Po skonfigurowaniu webhooka POST lub GET można wykonać test, aby zobaczyć odpowiedź webhooka. Podczas testu, gdy dane są wysyłane do i pobierane od strony trzeciej, istniejące rekordy w HubSpot nie zostaną naruszone. Jeśli używasz klucza API do uwierzytelniania, klucz API nie będzie wyświetlany w żądaniach testowych.

Po przetestowaniu swojego webhooka możnawybrać pola, które mają być wyprowadzone do wykorzystania jako dane wejściowe w dalszej części przepływu pracy. Wybierz tylko wyjścia dostępne w każdej odpowiedzi. Jeśli wyjście jest używane w późniejszej akcji, ale nie jest dostępne w odpowiedzi, akcja zakończy się niepowodzeniem.

  • W panelu bocznym kliknij Testuj akcję, aby rozwinąć sekcję.
  • Kliknij menu rozwijane Obiekt, a następnie wybierz Rekord do przetestowania.
  • Kliknij Test.
  • Aby sprawdzić szczegóły webhooka, wybierz zakładkę Response lub Request. Na każdej zakładce możesz kliknąć Otwórz wszystko, aby rozwinąć wszystkie sekcje lub Zwiń wszystko, aby zwinąć wszystkie sekcje.
    • W zakładce Odpowiedź, kliknij Headers: lub Body: aby rozwinąć każdą sekcję.
    • Na karcie Request kliknij httpHeaders: , aby rozwinąć sekcję.

Zewnętrzne testowanie webhooka

Po utworzeniu przepływu z akcją webhook, można przeprowadzić szybki test z użyciem atrapy adresu URL webhooka:

  • W przeglądarce przejdź do strony https://webhook.site i skopiuj unikalny adres URL.
  • W polu Webhook URL w swojej akcji webhook wklej adres URL.

Jeśli zostanie wywołana akcja webhook z żądaniem POST, do webhooka zostanie wysłana treść odpowiedzi JSON zawierająca wszystkie informacje o kontakcie, w tym przesłane formularze, przynależność do listy i 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 wywołana 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. Webhooks używane we wszystkich innych typach przepływów będą zwracały tylko najbardziej aktualne wartości.

Weryfikacja podpisów żądań w webhookach przepływu pracy

W przypadku wybrania opcji Podpis żądania w sekcji Uwierzytelnianie dla akcji Wyzwalanie web hooków, HubSpot wypełni webhook nagłówkiem X-HubSpot-Signature, zawierającym skrót SHA-256 konkatenacji sekretu aplikacji, metody HTTP, identyfikatora URI oraz niesparsowanego ciała. Dowiedz się więcej na ten temat w dokumentacji dla deweloperów.

Aby sprawdzić, czy żądania otrzymane 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.