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
- 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í
- Vpravo nahoře klikněte na své jméno → Nastavení.
- 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.
- jméno, třeba
- 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.
- Volitelně omezte, které záznamy uživatel uvidí: Nastavení → Bezpečnostní úrovně → Přidat úroveň, pojmenujte ji a vyberte uživatele.
API klíč
- Nastavení → v nabídce vlevo v části PRO VÝVOJÁŘE → API klíče.
- 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.
- Název klíče — třeba
- 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
- 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í.
- 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é:“.
- 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.
- 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áš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 |