Pro administrátory
← Na rozcestník

Raynet CRM: napojení

Uživatel jen pro čtení, API klíč a název instance v Raynetu a připojení v draftenu, krok za krokem.

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.

Co budete potřebovat

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.

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ášceCo 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í čístzkontrolovat roli a bezpečnostní úroveň uživatele
Raynet rate limit reached (429)vyčerpaný denní limit volání APIzkusit později; limit má Raynet podle tarifu
Raynet needs the instance name (letters, digits, dashes)název instance chybí nebo má neplatné znakyopsat název instance z O aplikaci Raynet CRM
Raynet answered HTTP …jiná odpověď Raynetuzkontrolovat název instance a zkusit znovu

Textová verze