HubSpot: podłączenie

Asystent czyta z HubSpota, kto do niego pisze: kontakt i firmę, szanse sprzedaży i zgłoszenia do wsparcia. Do HubSpota nigdy nic nie zapisuje. Co dokładnie może czytać, ustalasz osobno dla każdej skrzynki. Jak połączenia działają w draften ogólnie, opisuje strona Integracje.

Czego potrzebujesz

• Konta HubSpot z uprawnieniami super admin (albo z uprawnieniem Developer tools access) – tylko takie konto utworzy klucz do API.
• W draften właściciela lub menedżera organizacji.

draften potrzebuje klucza do API tylko z uprawnieniami do odczytu. HubSpot wydaje go dziś jako service key. Starsze konta mogą mieć też wcześniejszy token private app (zaczyna się od pat-); nadal działa, tylko nowych private apps HubSpot już nie pozwala tworzyć.

W HubSpocie: service key

1. Otwórz listę kluczy: w menu głównym Development → Keys → Service keys (na niektórych kontach Settings → Integrations → Service Keys).
2. W prawym górnym rogu kliknij Create service key i nazwij klucz, np. draften.
3. Kliknij Add new scope. W panelu po prawej wyszukaj (pole Find a scope) i zaznacz tylko te uprawnienia do odczytu:
   • crm.objects.contacts.read – kontakty,
   • crm.objects.companies.read – firmy,
   • crm.objects.owners.read – kto opiekuje się kontaktem,
   • crm.objects.deals.read – szanse sprzedaży,
   • crm.objects.tickets.read – zgłoszenia.

   Nie dodawaj niczego z .write. Klucz może dostać tylko te uprawnienia, które ma jego twórca.

4. Utwórz klucz. Na jego stronie kliknij Show, a potem Copy.

Klucz można później wymienić (Rotate and expire now albo Rotate and expire later – stary działa wtedy jeszcze 7 dni). Nowy klucz wpisz w draften (poniżej).

W draften

1. Otwórz Organizacja → Integracje i na karcie Integracje wypełnij:
   • System – HubSpot,
   • Nazwa – np. HubSpot – sprzedaż i wsparcie,
   • Sekret dostępowy – skopiowany klucz.

   Kliknij Dodaj połączenie. Klucz zostanie zapisany w postaci zaszyfrowanej i nigdy więcej się nie wyświetli.

2. W wierszu połączenia otwórz menu ⋯ → Przetestuj połączenie. Po chwili pojawi się „Połączenie działa (…)”. Brakujące uprawnienia test wypisze pod „Niedostępne z tym tokenem:”; jeśli klucz ma też uprawnienia do zapisu, zwróci na to uwagę.
3. W sekcji Które skrzynki mogą używać połączenia kliknij przy skrzynce Nadaj, zaznacz, co asystent może czytać, i kliknij Zapisz uprawnienie:
   • Kontakt i firma,
   • Szanse sprzedaży, a pod nimi Kwoty szans sprzedaży,
   • Zgłoszenia do wsparcia, a pod nimi Szczegóły zgłoszenia i Wewnętrzne notatki zgłoszenia.
4. Edytor asystenta dodaje potem w Ustawieniach asystenta → Wiedza źródło rodzaju system zewnętrzny i wybiera, co asystent faktycznie czyta – zobacz Podłączenie CRM i innych systemów.

Gdy wymienisz klucz, wpisz nowy przy połączeniu w pole Nowy sekret dostępowy i kliknij Wymień; potem znowu Przetestuj połączenie.

Błędy testu połączenia

Komunikat testu jest po angielsku, bezpośrednio od HubSpota albo od draften: