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.
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
- W prawym górnym rogu kliknij swoje imię → Nastavení (Ustawienia).
- 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.
- imię, np.
- 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.
- 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
- Nastavení → w menu po lewej w sekcji PRO VÝVOJÁŘE (Dla programistów) → API klíče (Klucze API).
- 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.
- Název klíče (Nazwa klucza) – np.
- 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
- 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.
- 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:”.
- 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.
- 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.
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 |