# 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](/pl/admin/integrations).

## 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](/pl/connecting-a-crm).

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:

| W komunikacie | Co to znaczy | Co zrobić |
|---|---|---|
| `the access token was refused (401)` | HubSpot nie przyjął klucza – literówka albo klucz został wymieniony lub usunięty | wpisać ważny klucz |
| `… lacks a scope for this read (403)` | kluczowi brakuje uprawnienia do odczytu | dodać uprawnienie do klucza w HubSpocie |
| `HubSpot rate limit reached (429)` | wyczerpany limit wywołań API | spróbować później |
| `HubSpot answered HTTP …` | inna odpowiedź HubSpota | spróbować ponownie; jeśli to trwa, wymienić klucz |