# Integracje

Organizacja → **Integracje** ma dwie karty: **Dostęp do poczty dla całej
organizacji** (rejestracje aplikacji, opisane na stronie
[Dostęp do poczty dla całej organizacji](/pl/admin/organisation-mail-access))
i **połączenia z systemami zewnętrznymi** – CRM i helpdeskami, z których mogą
czytać asystenci. Ta strona dotyczy tych drugich.

## Do czego służy połączenie

Połączenie pozwala asystentowi dowiedzieć się, kto pisze: jaka to firma, kto
się nią opiekuje, jakie ma szanse sprzedaży albo otwarte zgłoszenia. draften
współpracuje dziś z **HubSpot**, **Raynet CRM** i **FLOWii**.

Co obowiązuje przy każdym połączeniu:

- **tylko czyta** – konektor nie ma żadnego wywołania, które zapisuje;
- sprawdza **tylko uczestników wątku**, na który asystent odpowiada (nigdy
  własnego adresu skrzynki), a szczegóły tylko według tego, co zwróciło
  wcześniejsze wywołanie przy tym samym szkicu – e-mail z prośbą „sprawdź
  firmę X” niczego o X nie przeczyta;
- najwyżej 6 wywołań na szkic, każde do 10 sekund; system, który nie działa,
  nigdy nie zatrzyma szkicu;
- to, co zwróci, jest dla modelu obcym tekstem i nic z tego nie jest cytowane
  klientowi;
- dziennik podaje nazwę narzędzia, nigdy to, o kogo pytało.

Dane z połączenia, tak jak sam e-mail, trafiają do dostawcy modelu językowego.

## Dodanie połączenia

Wybierz **system**, wypełnij **tytuł** i **sekret dostępowy** (a przy Raynecie
i FLOWii kolejne pola). Sekret wpisuje się raz, jest przechowywany w postaci
zaszyfrowanej i nigdy więcej się nie wyświetla. Potem kliknij
**Przetestuj połączenie**: test sprawdzi, czyje to konto, które części sekret
otwiera, i ostrzeże, jeśli sekret pozwala też zapisywać.

| System | Sekret dostępowy |
|---|---|
| HubSpot | token prywatnej aplikacji (Settings → Integrations → Private apps, zaczyna się od `pat-`) tylko z zakresami do odczytu: contacts, companies, owners, deals, tickets |
| Raynet CRM | nazwa instancji (część adresu po app.raynet.cz/), e-mail logowania i klucz API użytkownika (Application settings → For developers → API keys). Raynet nie ma klucza tylko do odczytu – utwórz dla asystenta użytkownika z rolą tylko do odczytu |
| FLOWii | e-mail logowania i hasło użytkownika oraz klucz API konta (Extensions → API → New FLOWii REST API, tylko w płatnych licencjach); gdy logowanie obejmuje kilka firm, także ID firmy. Użyj użytkownika z możliwie najwęższą rolą |

## Udostępnienie skrzynkom

To, co zwraca połączenie, może pojawić się w szkicach – a szkice czyta każdy,
kto ma dostęp do skrzynki. Dlatego żadna skrzynka nie używa połączenia, dopóki
jej go nie udostępnisz:

- na karcie połączenia kliknij **Nadaj** przy skrzynce i zaznacz części, które
  może czytać (kontakt, szanse sprzedaży, kwoty, zgłoszenia, aktywności,
  notatki);
- to jest górna granica – edytor asystenta wybiera potem w zakładce Wiedza,
  co asystent faktycznie czyta;
- **Odbierz** wyłącza źródła wiedzy, które czytają przez to połączenie;
  usunięcie połączenia je usuwa.

Bez udostępnienia edytorzy skrzynki nawet nie wiedzą, że połączenie istnieje.

## Własne połączenie skrzynki

Właściciel skrzynki może podłączyć własny system, tylko dla swojej skrzynki.
Nikt go nie zatwierdza; właściciele i menedżerowie organizacji dostają e-mail
i mogą je wyłączyć albo usunąć. Dla użytkowników opisuje to strona
[Podłączenie CRM i innych systemów](/pl/connecting-a-crm).