Dla administratorów
← Wszystkie tematy

Raynet CRM: podłączenie

Użytkownik tylko do odczytu, klucz API i nazwa instancji w Raynecie oraz połączenie w draften, krok po kroku.

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

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.

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 komunikacieCo to znaczyCo zrobić
the user name or the API key was refused (401)Raynet nie przyjął e-maila albo kluczasprawdzić, 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ń APIspróbować później; limit Raynet ustala według taryfy
Raynet needs the instance name (letters, digits, dashes)brak nazwy instancji albo zawiera niedozwolone znakiprzepisać nazwę instancji z O aplikaci Raynet CRM
Raynet answered HTTP …inna odpowiedź Raynetusprawdzić nazwę instancji i spróbować ponownie

Wersja tekstowa