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.

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.

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: