Korzystanie z webhooków w agentach

Wykorzystaj akcje webhooków w agentach do wysyłania i odbierania danych z systemów zewnętrznych. W kreatorze agentów możesz skonfigurować akcje webhooków w celu wysyłania żądań HTTP (np. GET lub POST), uruchamiania procesów zewnętrznych lub pobierania danych.

Akcje webhooków pomagają połączyć agenty z narzędziami zewnętrznymi bez konieczności tworzenia niestandardowych integracji. Na przykład można wysłać dane dotyczące transakcji do systemu zewnętrznego, aby zainicjować realizację zamówienia, lub pobrać informacje o kliencie z innej platformy i wykorzystać je w wynikach działania agenta.

Uwaga: Możesz zarządzać dostępem do funkcji SI w ustawieniach SI i skonfigurować udostępniane dane. Zapoznaj się z często zadawanymi pytaniami dotyczącymi zaufania do SI i kartami modeli SI HubSpot, aby uzyskać szczegółowe informacje na temat kontroli bezpieczeństwa SI, wykorzystania danych, a także zgodności.

Zanim zaczniesz

Przed rozpoczęciem korzystania z webhooków w agentach zapoznaj się z wymaganiami i uwagami.

• Superadministrator musi włączyć następujące opcje w ustawieniach AI:
  • Udziel użytkownikom dostępu do narzędzi i funkcji generatywnej sztucznej inteligencji
  • Dane CRM
  • Dane dotyczące konwersji klientów
  • Dane dotyczące plików
  • Zapewnij użytkownikom dostęp do asystenta Breeze

Dodaj akcję webhooka do agenta

Dodaj akcję webhook w kreatorze agenta, aby wysyłać dane do systemu zewnętrznego lub pobierać dane z niego. Użyj menu rozwijanego „Metoda”, aby wybrać sposób komunikacji agenta z adresem URL webhooka:

• GET: pobieranie wartości z innego systemu. Używaj żądań GET, gdy agent musi odwołać się do informacji z systemu zewnętrznego w dalszej części działania agenta, takich jak status subskrypcji, status zamówienia lub pole profilu klienta.
• POST: wysyłaj wartości do innego systemu. Używaj żądań POST, gdy agent musi zainicjować lub zaktualizować coś poza HubSpotem, na przykład utworzyć zlecenie realizacji, wysłać powiadomienie lub zaktualizować rekord zewnętrzny.

Aby dodać akcję webhooka:

1. Na koncie HubSpot przejdź do sekcji Agenty > Hub agenta.
2. Kliknij kartę „Agenci ”.
3. Kliknij opcję „Edytuj ” na karcie istniejącego agenta lub utwórz nowego agenta.
4. W kreatorze agenta kliknij opcję Dodaj akcję w sekcji Akcje.
5. W prawym panelu wpisz „Wyślij webhook ” w polu „Wyszukaj ”. Następnie kliknij akcję „Wyślij webhook ”.
6. Kliknij menu rozwijane „Metoda” i wybierz typ żądania (np. POST lub GET).
7. W polu „Adres URL webhooka ” wprowadź adres URL, na który ma zostać wysłane żądanie.
8. Kliknij menu rozwijane „Typ uwierzytelniania ” i wybierz typ uwierzytelniania.
9. W zależności od wybranej metody (np. GET lub POST) skonfiguruj wartości, które mają zostać uwzględnione w żądaniu.
   • W przypadku żądań GET w sekcji „Parametry zapytania” kliknij opcję „Dodaj wartość statyczną”, aby dodać nazwy i wartości, które mają zostać dołączone do adresu URL webhooka.
   • W przypadku żądań POST w sekcji „Treść żądania” kliknij opcję „Dodaj wartość statyczną”, aby dodać wartości, które mają zostać uwzględnione w treści żądania webhooka.
10. Aby przetestować akcję webhooka, kliknij „Testuj”. Sprawdź odpowiedź, aby upewnić się, że żądanie zostało skonfigurowane poprawnie. Jeśli test zakończy się niepowodzeniem, sprawdź adres URL webhooka, metodę, typ uwierzytelniania, parametry zapytania lub treść żądania, a następnie ponownie przetestuj akcję.
11. Po zakończeniu kliknij „Zapisz i dodaj”.
12. Przejdź do dostosowywania agenta, a następnie opublikuj go.

Kolejne kroki

• Utwórz i dostosuj agentów w kreatorze agentów
• Uruchom agentów i przejrzyj wyniki w skrzynce odbiorczej agenta
• Sprawdź szacunkowe koszty kredytowe związane z korzystaniem z agentów