# Raynet CRM: napojení

Asistent si z Raynetu přečte, kdo mu píše: kontakt a firmu, obchodní případy,
nabídky a objednávky a aktivity. Do Raynetu 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

- Raynet s tarifem **PROFESSIONAL** nebo vyšším — tarif START API klíče
  nemá.
- Instanci na **app.raynet.cz** (český server). Instance na slovenském ani
  mezinárodních serverech Raynetu (`app.raynetcrm.sk`, `eu.raynetcrm.com`,
  `app.raynetcrm.com`) připojit nejde.
- **Administrátora Raynetu** — jen ten vytvoří uživatele a API klíč.
- V draftenu **vlastníka nebo správce organizace**.

## V Raynetu

Raynet nemá klíč jen pro čtení: API klíč má vždy práva uživatele, ke kterému
patří. Proto pro asistenta založte **samostatného uživatele s rolí jen ke
čtení**. Administrátorovi klíč nedávejte — administrátor vidí a smí všechno.

### Uživatel jen pro čtení

1. Vpravo nahoře klikněte na své jméno → **Nastavení**.
2. V nabídce vlevo otevřete **Uživatelské účty** a přidejte uživatele
   (**Přidat uživatele**; v placené verzi nejdřív **Přidat další uživatelské
   účty** a pak **Přiřadit uživatele**). Vyplňte:
   - jméno, třeba `draften`,
   - přihlašovací e-mail — zapamatujte si ho, draften ho bude potřebovat,
   - roli **Jen ke čtení**.

   Každý uživatel je v Raynetu placená licence.
3. Má-li uživatel už existovat: **Uživatelské účty** → otevřete jeho profil →
   **Oprávnění uživatele** → změňte roli na **Jen ke čtení** a uložte.
4. Volitelně omezte, které záznamy uživatel uvidí: **Nastavení** →
   **Bezpečnostní úrovně** → **Přidat úroveň**, pojmenujte ji a vyberte
   uživatele.

### API klíč

1. **Nastavení** → v nabídce vlevo v části **PRO VÝVOJÁŘE** → **API klíče**.
2. Klikněte na **Nový API klíč**. V okně **Vytvořit API klíč** vyplňte:
   - **Název klíče** — třeba `draften`,
   - **Uživatel** — uživatele jen pro čtení z předchozího kroku. Klíč bude
     číst s jeho oprávněními.
3. Klíč si **hned zkopírujte** — po uložení už ho Raynet znovu neukáže. Pak
   klikněte na **Vytvořit API klíč**.

### Název instance

Vpravo nahoře klikněte na své jméno → **O aplikaci Raynet CRM**; tam je
**název instance**. Je to zároveň část adresy za `app.raynet.cz/` — u adresy
`https://app.raynet.cz/firma` je to `firma`.

## V draftenu

1. Otevřete Organizace → **Integrace** a v kartě **Integrace** vyplňte:
   - **Systém** — **Raynet CRM**,
   - **Název** — třeba `Raynet – obchod`,
   - **Název instance** — z předchozího kroku,
   - **Uživatel (e-mail)** — přihlašovací e-mail uživatele jen pro čtení,
   - **Přístupový údaj** — API 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 (…), účet …“. Když uživatel něco číst nesmí,
   test to vypíše pod „S tímto tokenem nejsou dostupné:“.
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**,
   - **Obchodní případy** a pod nimi **Částky**,
   - **Nabídky a objednávky**,
   - **Aktivity** a pod nimi **Popis a řešení u aktivit**.
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 Raynetu nebo od draftenu:

| V hlášce | Co to znamená | Co udělat |
|---|---|---|
| `the user name or the API key was refused (401)` | Raynet nepřijal e-mail nebo klíč | zkontrolovat, že e-mail je přihlašovací e-mail uživatele, kterému klíč patří, a klíč vložit znovu |
| `the user of the API key may not read this (403)` | uživatel klíče nesmí číst | zkontrolovat roli a bezpečnostní úroveň uživatele |
| `Raynet rate limit reached (429)` | vyčerpaný denní limit volání API | zkusit později; limit má Raynet podle tarifu |
| `Raynet needs the instance name (letters, digits, dashes)` | název instance chybí nebo má neplatné znaky | opsat název instance z **O aplikaci Raynet CRM** |
| `Raynet answered HTTP …` | jiná odpověď Raynetu | zkontrolovat název instance a zkusit znovu |