Połącz NetSuite z Breeze Assistant

Połącz NetSuite z Breeze Assistant, aby uzyskać dostęp do rekordów NetSuite i pracować z nimi bez opuszczania HubSpot. Po połączeniu z NetSuite możesz poprosić Breeze Assistant o pobranie informacji z NetSuite oraz wykonanie obsługiwanych czynności na rekordach NetSuite.

Możesz na przykład poprosić Breeze Assistant o podsumowanie historii konta w NetSuite, wygenerowanie podsumowań i raportów na podstawie danych z NetSuite oraz uzyskanie informacji finansowych z NetSuite, takich jak historia płatności i otwarte faktury.

Zanim zaczniesz

Przed połączeniem NetSuite z Breeze Assistant zapoznaj się z poniższymi wymaganiami i uwagami.

Zapoznaj się z wymaganiami

• Przed podłączeniem NetSuite do Breeze Assistant administrator NetSuite musi wykonać poniższe czynności w systemie NetSuite.
• Zapoznaj się z wymaganiami dotyczącymi korzystania z Breeze Assistant.

Zapoznaj się z ograniczeniami i kwestiami, które należy wziąć pod uwagę

• NetSuite to usługa zewnętrzna. Podczas korzystania z łącznika obowiązują zasady dotyczące danych i prywatności firmy Oracle. Aby uzyskać więcej informacji, zapoznaj się z dokumentem Oracle „Powiązane ryzyka, środki kontroli i strategie ograniczania ryzyka ”.
• Usługa NetSuite AI Connector nie została poddana ocenie pod kątem zgodności z HIPAA i nie powinna być wykorzystywana do przechowywania, przetwarzania ani przesyłania elektronicznych chronionych informacji zdrowotnych (ePHI). Jeśli w koncie HubSpot masz włączoną opcję „Dane wrażliwe”, zaleca się niekorzystanie z tego łącznika. Dowiedz się więcej o NetSuite i HIPAA.
• Przed zatwierdzeniem zmian zapoznaj się z propozycjami zmian przedstawionymi przez Breeze Assistant.
• Nie można usuwać danych z NetSuite za pośrednictwem tego łącznika.
• Domyślnie tokeny uwierzytelniające są ważne przez 48 godzin. W NetSuite można przedłużyć ten okres ważności do maksymalnie 30 dni. Po wygaśnięciu tokenu konieczne jest ponowne uwierzytelnienie połączenia.

Czynności administratora w NetSuite

Przed połączeniem NetSuite z Breeze Assistant administrator NetSuite musi wykonać następujące czynności w NetSuite.

1. Włącz wymagane funkcje NetSuite

Przed rozpoczęciem korzystania z łącznika NetSuite w Breeze Assistant administrator NetSuite musi włączyć wymagane funkcje SuiteCloud.

1. W NetSuite przejdź do sekcji „Setup ” > „Company ” > „Enable Features”.
2. Kliknij podzakładkę „SuiteCloud ”.
3. W sekcji SuiteScript:
• Zaznacz pole wyboru „Client SuiteScript ”. Jeśli pojawi się monit, kliknij „Zgadzam się”, aby zaakceptować Warunki korzystania z usługi SuiteCloud.
• Zaznacz pole wyboru „Server SuiteScript ”. Jeśli pojawi się monit, kliknij „Zgadzam się”, aby zaakceptować Warunki korzystania z usługi SuiteCloud.

4. W sekcji Zarządzaj uwierzytelnianiem zaznacz pole wyboru OAuth 2.0. Jeśli pojawi się monit, kliknij Zgadzam się, aby zaakceptować Warunki korzystania z usługi SuiteCloud.
5. W sekcji „SuiteTalk (usługi internetowe) ” zaznacz pole wyboru „Usługi internetowe REST ”.

6. Kliknij „Zapisz”.

2. Skonfiguruj rolę w NetSuite dla łącznika

Każdy użytkownik, który potrzebuje dostępu do łącznika, musi posiadać rolę w NetSuite z wymaganymi uprawnieniami. Należy rozważyć utworzenie dedykowanej roli dla łącznika zamiast dodawania tych uprawnień do istniejącej roli o szerszym zakresie dostępu.

Skonfiguruj uprawnienia roli

1. W systemie NetSuite przejdź do sekcji Konfiguracja > Użytkownicy/Role > Zarządzaj rolami.
2. Aby skonfigurować istniejącą rolę, kliknij przycisk Edytuj obok tej roli. Aby utworzyć rolę, kliknij przycisk Nowy.
3. Kliknij podkartę „Uprawnienia ”, a następnie kliknij „Konfiguracja”.
4. Dodaj następujące uprawnienia:
   • Połączenie z serwerem MCP: wybierz opcję Pełny dostęp. To uprawnienie pozwala użytkownikom łączyć się z usługą AI Connector.
   • Logowanie przy użyciu tokenów dostępu OAuth 2.0: wybierz opcję Pełny dostęp. To uprawnienie umożliwia uwierzytelnianie za pomocą OAuth 2.0.
   • Usługi internetowe REST: wybierz opcję Pełny dostęp, jeśli użytkownicy będą tworzyć, pobierać lub aktualizować rekordy za pośrednictwem aplikacji MCP Standard Tools SuiteApp.

5. Kliknij „Zapisz”.

Uwaga: po utworzeniu roli w NetSuite może minąć trochę czasu, zanim rola ta stanie się dostępna. Przed kontynuowaniem konfiguracji należy poczekać, aż rola będzie dostępna.

Dodaj uprawnienia do rekordów do roli

Dodaj uprawnienia do rekordów dla obiektów NetSuite, które ma pobierać Breeze Assistant, takich jak zamówienia sprzedaży, faktury i płatności klientów.

1. W systemie NetSuite przełącz się na rolę administratora.
2. Przejdź do sekcji Konfiguracja > Użytkownicy/Role > Zarządzaj rolami.
3. Otwórz rolę utworzoną dla łącznika NetSuite.
4. Przejdź do sekcji Uprawnienia > Transakcje.
5. Dodaj uprawnienia dla obiektów NetSuite, które ma pobierać Breeze Assistant, a następnie ustaw poziom dostępu dla każdego uprawnienia na Pełny. Możesz na przykład dodać uprawnienia do zamówień sprzedaży, faktur, płatności klientów lub innych obiektów NetSuite. 
6. Kliknij „Zapisz”.

Przypisz rolę do użytkowników

1. W NetSuite przejdź do sekcji Listy > Pracownicy > Pracownicy.
2. Kliknij opcję „Edytuj ” obok użytkownika, któremu chcesz przypisać rolę.
3. Przejdź do zakładki Dostęp.
4. W sekcji „Rola” wyszukaj i wybierz rolę skonfigurowaną w poprzednich krokach.
5. Kliknij Dodaj.
6. Następnie kliknij „Zapisz”.

Uwaga: usługa NetSuite AI Connector Service nie może działać w ramach roli administratora ani żadnej innej roli z pełnym dostępem do funkcji NetSuite. To zabezpieczenie pomaga zapobiegać niezamierzonym skutkom w przypadku naruszenia bezpieczeństwa zewnętrznego klienta AI.

3. Zainstaluj aplikację SuiteApp MCP Standard Tools

Aby korzystać z łącznika NetSuite w aplikacji Breeze Assistant, zainstaluj aplikację MCP Standard Tools SuiteApp. Aplikacja SuiteApp umożliwia wyszukiwanie danych NetSuite w aplikacji Breeze Assistant przy użyciu języka naturalnego.

Aplikacja SuiteApp wykorzystuje istniejącą rolę i uprawnienia użytkownika w NetSuite do określenia, do jakich danych i działań ma on dostęp.

1. Zaloguj się do NetSuite jako administrator NetSuite.
2. Kliknij kartę „SuiteApps ”.
3. W polu „Wyszukaj SuiteApps ” wpisz „MCP Standard Tools”.
4. Kliknij ikonę MCP Standard Tools.
5. W prawym górnym rogu strony SuiteApp kliknij przycisk „Zainstaluj”.
6. Poczekaj, aż instalacja się zakończy.

4. Utwórz rekord integracji OAuth 2.0

Utwórz rekord integracji w NetSuite, aby skonfigurować uwierzytelnianie OAuth 2.0 między NetSuite a HubSpot. Dowiedz się więcej z dokumentacji NetSuite.

1. W NetSuite przejdź do sekcji „Konfiguracja ” > „Integracja ” > „Zarządzaj integracjami ” > „Nowa”.
2. Wprowadź nazwę integracji.
3. Ustaw pole „Stan ” na „Włączone”.
4. W sekcji Zakresy OAuth 2.0:

• • Zaznacz pole wyboru „Przyznanie kodu autoryzacyjnego ”.

• • Odznacz pole wyboru „Public Client ”. Do połączenia NetSuite z HubSpot wymagany jest sekret klienta.
  • W polu „Redirect URI ” wprowadź adres URI przekierowania HubSpot. Adres URI musi mieć postać https://oauth-redirect.hubspot.com/callback/netsuite_mcp.

• • Zaznacz pole wyboru „Usługa łącznika AI NetSuite ”.
  • Odznacz pozostałe pola wyboru zakresu OAuth, w tym „RESTlets”, „REST Web Services” i „SuiteAnalytics Connect”.

5. Odznacz wszystkie pola wyboru w sekcjach „Uwierzytelnianie oparte na tokenach” i „Dane uwierzytelniające klienta ”, w tym pole wyboru „Uprawnienie danych uwierzytelniających klienta (maszyna do maszyny) ”.
6. Kliknij „Zapisz”.
7. Skopiuj i bezpiecznie przechowaj wygenerowany identyfikator klienta (Client ID ) oraz klucz tajny klienta (Client Secret).

Uwaga: identyfikator klienta (Client ID ) i tajny klucz klienta (Client Secret) pojawiają się dopiero po pierwszym zapisaniu rekordu integracji. Jeśli nie zapiszesz tych wartości, będziesz musiał zresetować je w rekordzie integracji, aby wygenerować nowe poświadczenia.

5. Znajdź adres URL serwera NetSuite MCP

Adres URL serwera MCP jest specyficzny dla danego konta NetSuite i określa, które narzędzia są dostępne za pośrednictwem tego połączenia.

Znajdź identyfikator swojego konta

1. W systemie NetSuite przejdź do sekcji Konfiguracja > Firma > Informacje o firmie.
2. Znajdź identyfikator konta u góry strony.
3. Kliknij kartę „Adresy URL firmy ”, aby sprawdzić adres URL SuiteTalk przypisany do tego konta.

Skonfiguruj odpowiedni adres URL serwera MCP

• Aby skorzystać z aplikacji SuiteApp „MCP Standard Tools”, użyj adresu:
  https://<identyfikator_konta>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
• Aby wyświetlić wszystkie dostępne aplikacje SuiteApp i projekty dostosowywania konta, użyj adresu:
  https://<identyfikator_konta>.suitetalk.api.netsuite.com/services/mcp/v1/all
• Aby wyświetlić konkretną aplikację SuiteApp, użyj:
  https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/<publisherid>.<projectid>
• Zastąp <accountid> identyfikatorem swojego konta NetSuite.

Połącz NetSuite z Breeze Assistant

Po skonfigurowaniu łącznika w NetSuite przez administratora, połącz NetSuite z Breeze Assistant. Przed rozpoczęciem przygotuj adres URL serwera MCP NetSuite, identyfikator klienta (Client ID) oraz tajny klucz klienta (Client Secret ).

1. Na koncie HubSpot kliknij ikonę Marketplace w górnym panelu nawigacyjnym, następnie wybierz HubSpot Marketplace.
2. Wyszukaj i wybierz NetSuite Connector.
3. Kliknij „Zainstaluj”.
4. W oknie dialogowym:
   • W polu „Adres URL serwera NetSuite MCP ” wprowadź adres URL serwera NetSuite MCP dla swojego konta NetSuite.
   • W polu „Client ID ” wprowadź identyfikator klienta wygenerowany na podstawie rekordu integracji NetSuite.
   • W polu „Klucz tajny klienta ” wprowadź klucz tajny klienta wygenerowany na podstawie rekordu integracji NetSuite.
5. Kliknij „Połącz z netsuite_mcp”.

6. Zostaniesz przekierowany do serwisu NetSuite. Zaloguj się, korzystając z konta o uprawnieniach innych niż administratora, ale posiadającego wymagane uprawnienia MCP, a następnie autoryzuj HubSpot do dostępu do serwisu NetSuite.
7. Po autoryzacji zostaniesz przekierowany do HubSpot, a połączenie zostanie nawiązane.

Korzystaj z łącznika w Breeze Assistant

Po nawiązaniu połączenia poproś Breeze Assistant o pobranie informacji lub wykonanie czynności w NetSuite.

1. Na górnym pasku nawigacyjnym kliknij „Breeze Assistant”. 
2. Kliknij „+”, a następnie przejdź do sekcji „Connectors”.
3. Kliknij, aby włączyć przełącznik łącznika NetSuite.
4. Następnie wprowadź swój komunikat.
   Na przykład możesz: 

• • Poproś asystenta Breeze o wyświetlenie 5 ostatnich zamówień sprzedaży dla konkretnej firmy w NetSuite, w tym pozycji, kwot i aktualnego statusu.
  • Poproś asystenta Breeze o wyświetlenie wszystkich otwartych faktur przeterminowanych o ponad 60 dni we wszystkich spółkach zależnych w NetSuite, posortowanych według kwoty.
  • Poproś asystenta Breeze o wyświetlenie wszystkich zamówień sprzedaży utworzonych w tym tygodniu w systemie NetSuite, które nadal mają status „oczekujące na realizację”.
  • Poproś asystenta Breeze o porównanie całkowitych przychodów poszczególnych spółek zależnych w systemie NetSuite za pierwszy kwartał bieżącego roku z przychodami za drugi kwartał bieżącego roku.
  • Poproś Breeze Assistant o wyświetlenie wszystkich klientów w konkretnej spółce zależnej w systemie NetSuite, którzy złożyli swoje pierwsze zamówienie w systemie NetSuite w ciągu ostatnich 6 miesięcy.
  • Poproś Breeze Assistant o przedstawienie pełnego podsumowania konta dla konkretnej firmy w systemie NetSuite, obejmującego wszystkie zamówienia, faktury, płatności i nierozstrzygnięte sprawy.

5. Kliknij ikonę „Wyślij” w prawym dolnym rogu.
6. Asystent Breeze wygeneruje odpowiedź na podstawie danych z NetSuite.