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: października 18, 2021

Dotyczy:

Operacje Hub Professional

Używaj webhooków w przepływach pracy, aby przekazywać informacje z HubSpot do innej aplikacji internetowej.

Istnieje wiele różnych zastosowań webhooków, takich jak wysyłanie danych i powiadomień. Przykłady popularnych przypadków użycia webhooków obejmują:

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

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

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

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 lub przekroczenia limitu czasu webhooka, 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. W dokumentacji dla programistów HubSpot można znaleźć informacje na temat konkretnych wyjątków kodów błędów.

Aby uzyskać więcej informacji na temat technicznych aspektów webhooków, zapoznaj się z dokumentacją dla programistów HubSpot.

Skonfiguruj webhook w swoim przepływie pracy

  • W koncie HubSpot przejdź do Automatyzacja > Przepływy pracy.
  • Kliknijnazwę przepływu pracy.
  • Kliknij ikonę +, aby dodać akcję.
  • W prawym panelu wybierz opcjęWyzwalaj webhook.
  • Wpisz adres URL webhooka. Adresy webhooków są ograniczone do bezpiecznego protokołu i muszą zaczynać się od HTTPS.
  • Zaznacz pole wyboruUse Request Signature, aby uwierzytelnić wszelkie żądania do Twojego webhooka i wprowadź swój App ID. Dowiedz się, jakweryfikować podpisy żądań.
  • Kliknij przyciskZapisz.

Uwaga: akcja Trigger a webhook obsługuje tylko metodę POST.

Przetestuj swój webhook

Po utworzeniu przepływu pracy z akcją webhooka, możesz 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, który został utworzony automatycznie. W polu Webhook URL w swojej akcji webhook, wklej ten adres URL.

trigger-a-webhook-action


Po wyzwoleniu akcji webhook do webhooka zostanie wysłana treść odpowiedzi JSON zawierająca wszystkie informacje o kontakcie, w tym przesłane formularze, członkostwo na liście 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.

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ą tylko najbardziej aktualną wartość.

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

Weryfikacja podpisów żądań w webhookach przepływu 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 i nieprzetworzonego 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: