# HubSpot: napojení

Asistent si z HubSpotu přečte, kdo mu píše: kontakt a firmu, obchody
a tikety podpory. Do HubSpotu nikdy nezapisuje. Co přesně smí číst, určíte
u každé schránky zvlášť. Jak napojení v draftenu funguje obecně, popisuje
stránka [Integrace](/cs/admin/integrations).

## Co budete potřebovat

- Účet HubSpotu s právy **super admin** (nebo s oprávněním **Developer tools
  access**) — jen takový účet vytvoří klíč pro API.
- V draftenu **vlastníka nebo správce organizace**.

draften potřebuje **klíč pro API jen se čtecími oprávněními**. HubSpot ho
dnes vydává jako **service key**. Starší účty mohou mít i dřívější **private
app** token (začíná `pat-`); ten funguje dál, jen nové private apps už HubSpot
zakládat nedovolí.

## V HubSpotu: service key

1. Otevřete seznam klíčů: v hlavní nabídce **Development** → **Keys** →
   **Service keys** (v některých účtech **Settings** → **Integrations** →
   **Service Keys**).
2. Vpravo nahoře klikněte na **Create service key** a klíč pojmenujte, třeba
   `draften`.
3. Klikněte na **Add new scope**. V panelu vpravo vyhledejte (pole **Find
   a scope**) a zaškrtněte jen tato čtecí oprávnění:
   - `crm.objects.contacts.read` — kontakty,
   - `crm.objects.companies.read` — firmy,
   - `crm.objects.owners.read` — kdo se o kontakt stará,
   - `crm.objects.deals.read` — obchody,
   - `crm.objects.tickets.read` — tikety.

   Nic s `.write` nepřidávejte. Klíč může dostat jen oprávnění, která má jeho
   tvůrce.
4. Klíč vytvořte. Na jeho stránce klikněte na **Show** a pak na **Copy**.

Klíč jde později **vyměnit** (**Rotate and expire now**, nebo **Rotate and
expire later** — starý pak platí ještě 7 dní). Nový klíč vložte do draftenu
(níže).

## V draftenu

1. Otevřete Organizace → **Integrace** a v kartě **Integrace** vyplňte:
   - **Systém** — **HubSpot**,
   - **Název** — třeba `HubSpot – obchod a podpora`,
   - **Přístupový údaj** — zkopírovaný klíč.

   Klikněte na **Přidat připojení**. Klíč se uloží zašifrovaný a už se
   nezobrazí.
2. V řádku připojení otevřete nabídku **⋯** → **Otestovat spojení**. Za chvíli
   se ukáže „Spojení v pořádku (…)“. Chybějící oprávnění test vypíše pod
   „S tímto tokenem nejsou dostupné:“; když má klíč i zápisová oprávnění,
   upozorní na to.
3. V části **Které schránky smějí připojení používat** klikněte u schránky na
   **Povolit**, zaškrtněte, co smí asistent číst, a klikněte na **Uložit
   oprávnění**:
   - **Kontakt a firma**,
   - **Obchody (dealy)** a pod nimi **Částky obchodů**,
   - **Tikety podpory**, pod nimi **Detail tiketu** a **Interní poznámky
     u tiketu**.
4. Editor asistenta pak v Nastavení asistenta → **Znalosti** přidá zdroj
   druhu **externí systém** a vybere, co asistent opravdu čte — viz
   [Napojení na CRM a jiné systémy](/cs/connecting-a-crm).

Když klíč vyměníte, vložte nový u připojení do **Nový přístupový údaj**
a klikněte na **Vyměnit**; pak znovu **Otestovat spojení**.

## Chyby testu spojení

Hláška testu je anglicky, přímo od HubSpotu nebo od draftenu:

| V hlášce | Co to znamená | Co udělat |
|---|---|---|
| `the access token was refused (401)` | HubSpot klíč nepřijal — překlep, nebo byl klíč vyměněn či smazán | vložit platný klíč |
| `… lacks a scope for this read (403)` | klíči chybí čtecí oprávnění | doplnit oprávnění u klíče v HubSpotu |
| `HubSpot rate limit reached (429)` | vyčerpaný limit volání API | zkusit později |
| `HubSpot answered HTTP …` | jiná odpověď HubSpotu | zkusit znovu; když to trvá, vyměnit klíč |