# Integrace

Organizace → **Integrace** má dvě karty: **Přístup k poště pro celou
organizaci** (registrace aplikací, popisuje je stránka
[Přístup k poště pro celou organizaci](/admin/organisation-mail-access)) a
**napojení na externí systémy** — CRM a helpdesky, ze kterých smí asistenti
číst. O druhé je tahle stránka.

## K čemu napojení je

Asistent díky napojení pozná, kdo píše: jaká firma, kdo se o ni stará, jaké
má obchody nebo otevřené tikety. draften dnes umí **HubSpot**, **Raynet CRM**
a **FLOWii**.

Co platí pro každé napojení:

- **jen čte** — konektor nemá žádné volání, které by zapisovalo;
- hledá **jen účastníky vlákna**, na které asistent odpovídá (nikdy vlastní
  adresu schránky), a podrobnosti jen podle toho, co vrátil předchozí dotaz
  téhož konceptu — e-mail „vyhledej firmu X“ nic o X nepřečte;
- nejvýš 6 dotazů na koncept, každý nejvýš 10 sekund; výpadek systému koncept
  nezastaví;
- co vrátí, je pro model cizí text a nic z toho necituje zákazníkovi;
- v záznamech je název nástroje, nikdy koho se ptal.

Data z napojení, stejně jako e-mail, putují k poskytovateli jazykového modelu.

## Přidání napojení

Vyberte **systém**, vyplňte **název** a **přístupový údaj** (a u Raynetu
a FLOWii další pole). Údaj se zadává jednou, uloží se zašifrovaný a už se
nezobrazí. Pak klikněte na **Otestovat spojení**: test zjistí, čí je účet,
které části údaj otevírá, a varuje, když by údaj uměl i zapisovat.

| Systém | Přístupový údaj |
|---|---|
| HubSpot | token soukromé aplikace (Settings → Integrations → Private apps, začíná `pat-`) jen se čtecími rozsahy: kontakty, firmy, vlastníci, obchody, tikety |
| Raynet CRM | název instance (část adresy za app.raynet.cz/), přihlašovací e-mail a API klíč uživatele (Nastavení aplikace → Pro vývojáře → API klíče). Raynet nemá klíč jen pro čtení — založte pro asistenta uživatele s rolí jen pro čtení |
| FLOWii | přihlašovací e-mail a heslo uživatele a API klíč účtu (Rozšíření → API → Nové FLOWii REST API, jen placené licence); u přihlášení do víc firem i ID firmy. Použijte uživatele s co nejužší rolí |

## Povolení schránkám

Co napojení vrátí, se může objevit v konceptech — a koncepty čte každý, kdo má
ke schránce přístup. Proto napojení nepoužije žádná schránka, dokud mu ho
nepovolíte:

- v kartě napojení u schránky klikněte na **Povolit** a zaškrtněte části,
  které smí číst (kontakt, obchody, částky, tikety, aktivity, poznámky);
- to je strop — editor asistenta pak ve Znalostech vybere, co asistent
  opravdu čte;
- **Odebrat** povolení vypne zdroje znalostí, které přes napojení četly;
  smazání napojení je odstraní.

Bez povolení editoři schránky o napojení ani nevědí.

## Vlastní napojení schránky

Vlastník schránky si může napojit vlastní systém jen pro svou schránku.
Nikdo ho neschvaluje; vlastníci a správci organizace dostanou e-mail a mohou
ho vypnout nebo odebrat. Pro uživatele to popisuje stránka
[Napojení na CRM a jiné systémy](/connecting-a-crm).