# Raynet CRM: podłączenie

Asystent czyta z Raynetu, kto do niego pisze: kontakt i firmę, sprawy
handlowe, oferty i zamówienia oraz aktywności. Do Raynetu nigdy nic nie
zapisuje. Co dokładnie może czytać, ustalasz osobno dla każdej skrzynki. Jak
połączenia działają w draften ogólnie, opisuje strona
[Integracje](/pl/admin/integrations).

## Czego potrzebujesz

- Raynetu w taryfie **PROFESSIONAL** lub wyższej – taryfa START nie ma
  kluczy API.
- Instancji na **app.raynet.cz** (serwer czeski). Instancji na słowackim ani
  na międzynarodowych serwerach Raynetu (`app.raynetcrm.sk`,
  `eu.raynetcrm.com`, `app.raynetcrm.com`) nie da się podłączyć.
- **Administratora Raynetu** – tylko on utworzy użytkownika i klucz API.
- W draften **właściciela lub menedżera organizacji**.

## W Raynecie

Raynet nie ma klucza tylko do odczytu: klucz API ma zawsze uprawnienia
użytkownika, do którego należy. Dlatego utwórz dla asystenta **osobnego
użytkownika z rolą tylko do odczytu**. Nie wystawiaj klucza na administratora
– administrator widzi wszystko i może wszystko.

### Użytkownik tylko do odczytu

1. W prawym górnym rogu kliknij swoje imię → **Nastavení** (Ustawienia).
2. W menu po lewej otwórz **Uživatelské účty** (Konta użytkowników) i dodaj
   użytkownika (**Přidat uživatele**; w płatnej wersji
   najpierw **Přidat další uživatelské účty**, a potem **Přiřadit
   uživatele**). Wypełnij:
   - imię, np. `draften`,
   - e-mail logowania – zapamiętaj go, draften będzie go potrzebował,
   - rolę **Jen ke čtení** (Tylko do odczytu).

   Każdy użytkownik to w Raynecie płatna licencja.
3. Jeśli użytkownik już istnieje: **Uživatelské účty** → otwórz jego profil →
   **Oprávnění uživatele** (Uprawnienia użytkownika) → zmień rolę na **Jen ke
   čtení** i zapisz.
4. Opcjonalnie ogranicz, które rekordy użytkownik zobaczy: **Nastavení** →
   **Bezpečnostní úrovně** (Poziomy bezpieczeństwa) → **Přidat úroveň**,
   nazwij poziom i wybierz użytkownika.

### Klucz API

1. **Nastavení** → w menu po lewej w sekcji **PRO VÝVOJÁŘE** (Dla
   programistów) → **API klíče** (Klucze API).
2. Kliknij **Nový API klíč** (Nowy klucz API). W oknie **Vytvořit API klíč**
   (Utwórz klucz API) wypełnij:
   - **Název klíče** (Nazwa klucza) – np. `draften`,
   - **Uživatel** (Użytkownik) – użytkownika tylko do odczytu z poprzedniego
     kroku. Klucz będzie czytał z jego uprawnieniami.
3. **Od razu skopiuj** klucz – po zapisaniu Raynet już go nie pokaże. Potem
   kliknij **Vytvořit API klíč**.

### Nazwa instancji

W prawym górnym rogu kliknij swoje imię → **O aplikaci Raynet CRM**
(O aplikacji Raynet CRM); tam znajdziesz **nazwę instancji**. To zarazem
część adresu po `app.raynet.cz/` – dla adresu `https://app.raynet.cz/firma`
jest to `firma`.

## W draften

1. Otwórz Organizacja → **Integracje** i na karcie **Integracje** wypełnij:
   - **System** – **Raynet CRM**,
   - **Nazwa** – np. `Raynet – sprzedaż`,
   - **Nazwa instancji** – z poprzedniego kroku,
   - **Użytkownik (e-mail)** – e-mail logowania użytkownika tylko do odczytu,
   - **Sekret dostępowy** – klucz API.

   Kliknij **Dodaj połączenie**. Klucz zostanie zapisany w postaci
   zaszyfrowanej i nigdy więcej się nie wyświetli.
2. W wierszu połączenia otwórz menu **⋯** → **Przetestuj połączenie**. Po
   chwili pojawi się „Połączenie działa (…), konto …”. Jeśli użytkownik
   czegoś czytać nie może, test wypisze to pod „Niedostępne z tym tokenem:”.
3. W sekcji **Które skrzynki mogą używać połączenia** kliknij przy skrzynce
   **Nadaj**, zaznacz, co asystent może czytać, i kliknij **Zapisz
   uprawnienie**:
   - **Kontakt i firma**,
   - **Sprawy handlowe**, a pod nimi **Kwoty**,
   - **Oferty i zamówienia**,
   - **Aktywności**, a pod nimi **Opis i rozwiązanie aktywności**.
4. Edytor asystenta dodaje potem w Ustawieniach asystenta → **Wiedza** źródło
   rodzaju **system zewnętrzny** i wybiera, co asystent faktycznie czyta –
   zobacz [Podłączenie CRM i innych systemów](/pl/connecting-a-crm).

Gdy wymienisz klucz, wpisz nowy przy połączeniu w pole **Nowy sekret
dostępowy** i kliknij **Wymień**; potem znowu **Przetestuj połączenie**.

## Błędy testu połączenia

Komunikat testu jest po angielsku, bezpośrednio od Raynetu albo od draften:

| W komunikacie | Co to znaczy | Co zrobić |
|---|---|---|
| `the user name or the API key was refused (401)` | Raynet nie przyjął e-maila albo klucza | sprawdzić, czy e-mail to e-mail logowania użytkownika, do którego należy klucz, i wkleić klucz ponownie |
| `the user of the API key may not read this (403)` | użytkownik klucza nie może czytać | sprawdzić rolę i poziom bezpieczeństwa użytkownika |
| `Raynet rate limit reached (429)` | wyczerpany dzienny limit wywołań API | spróbować później; limit Raynet ustala według taryfy |
| `Raynet needs the instance name (letters, digits, dashes)` | brak nazwy instancji albo zawiera niedozwolone znaki | przepisać nazwę instancji z **O aplikaci Raynet CRM** |
| `Raynet answered HTTP …` | inna odpowiedź Raynetu | sprawdzić nazwę instancji i spróbować ponownie |