Raynet
Plugin Raynet propojuje Elowen s Raynet CRM přes Raynet API v2. Asistent získá nástroje pro vyhledávání, čtení, zakládání, úpravy a mazání záznamů Raynetu i pro akce nad nimi — třeba klienty, obchodní případy, nabídky a aktivity. Plugin také přidá do levého menu stránku Raynet, kde si můžete CRM procházet a přihlásit se vlastním účtem Raynetu.
Všichni pracují pod firemním účtem Raynetu, který nastaví administrátor, dokud si někdo nezapne vlastní údaje.
Instalace
- Otevřete Nastavení → Dostupné pluginy a nainstalujte Raynet. Tržiště nabízí jen pluginy, které Vaše licence povoluje.
- Otevřete Nastavení → Přístupy → Raynet a vyplňte Název instance, Firemní uživatelské jméno a Firemní API klíč.
- V nastavení pluginu v části Nastavení → Pluginy zvolte Režim přístupu a Povolit přímé požadavky nechte vypnuté, dokud je nepotřebujete.
- Přidělte plugin každému, kdo ho má používat. Otevřete Uživatelé, vyberte účet a použijte Spravovat přidělené pluginy.
Aktuální verzi pluginu a jeho minimální verzi Elowen najdete v registru.
Nastavení administrátora
Tři pole s přihlašovacími údaji najdete v Nastavení → Přístupy → Raynet; pole s pravidly jsou v nastavení pluginu v části Nastavení → Pluginy.
| Nastavení | Výchozí hodnota | Co dělá |
|---|---|---|
| Název instance | Povinné, bez výchozí hodnoty | Název Vaší instance Raynetu malými písmeny přesně tak, jak ho Raynet píše. Na chybný název odpoví „Instance not found“, ne chybou přihlášení. Platí pro všechny. |
| Firemní uživatelské jméno | Prázdné | Přihlášení do Raynetu, pod kterým pracují všichni, kdo si nezapnuli vlastní údaje. Použijí ho i běhy bez obsluhy, například naplánovaná úloha bez vlastníka nebo webhook. |
| Firemní API klíč | Prázdný | API klíč firemního přihlášení (v Raynetu: Uživatelské nastavení → API klíč). Ukládá se na serveru a znovu se nezobrazí. |
| Povolit vlastní přihlašovací údaje | Zapnuto | Umožní uživateli přepnout se na vlastní přihlášení do Raynetu, aby se jeho práce připisovala jemu. Když je vypnuto, pracují všichni pod firemním účtem a uložené osobní údaje se ignorují. |
| Režim přístupu | Čtení a zápis (včetně mazání) | Určuje, co smí asistent v CRM dělat. Podrobnosti níže. |
| Povolit přímé požadavky | Vypnuto | Zapne nástroj RaynetRequest, který umí zavolat libovolný endpoint API. |
Režim přístupu omezuje, co smí jeden tah v CRM udělat:
- Pouze čtení: asistent může záznamy vyhledávat a číst.
- Čtení a zápis (včetně mazání): asistent může navíc zakládat a upravovat záznamy a smazat jeden záznam.
- Plný (včetně slučování a anonymizace): asistent může navíc slučovat a anonymizovat záznamy a spouštět další operace, které nejdou vrátit.
Každá nevratná operace navíc vyžaduje výslovné potvrzení ve volání nástroje. Přímé požadavky zůstávají vypnuté, dokud je administrátor nezapne, a přímý zápis vyžaduje plný režim.
Práce se stránkou Raynet
- Klikněte na Raynet v levém menu. Hlavička ukazuje instanci, počet typů záznamů, zbývající požadavky na dnešní den a co asistent smí.
- V poli Typ záznamu vyberte typ záznamu; jeho nejnovější záznamy se zobrazí hned. Zadáním do vyhledávacího pole a kliknutím na Hledat je zúžíte. Bez hledaného textu řadí Raynet seznam od nejnovějšího.
- Kliknutím na záhlaví sloupce, které je tlačítkem, seřadíte podle tohoto sloupce. Mezi stránkami se pohybujete tlačítky Zpět a Další.
- Kliknutím na řádek otevřete vedle seznamu Detail. Skryjete ho tlačítkem Zavřít.
Pokud ještě nejste přihlášeni, stránka zobrazí skupinu Přihlášení do Raynetu, která je zpočátku sbalená. Otevřete ji a podle těchto kroků budete pracovat pod vlastním přihlášením:
- Zapněte Používat vlastní přihlášení do Raynetu.
- Zadejte Uživatelské jméno a API klíč. Klíč najdete v Raynetu v Uživatelské nastavení → API klíč.
- Klikněte na Uložit a ověřit připojení. Stránka pak oznámí, zda Raynet přihlášení přijal.
Nechte pole API klíč prázdné, chcete-li zachovat klíč, který už máte uložený. Chcete-li se vrátit k firemnímu účtu, vypněte Používat vlastní přihlášení do Raynetu a uložte. Uložený klíč zůstane na místě. Ověřit uložené údaje zopakuje ověření připojení, aniž by cokoli ukládalo.
Pokud hledání nic nenajde, stránka zobrazí Nic nenalezeno. Pokud se Raynet nedá dosáhnout, zobrazí Data z Raynetu se nepodařilo načíst s tlačítkem pro opakování.
Nástroje Raynetu pro asistenta
| Nástroj | Co dělá |
|---|---|
| RaynetSearch | Vypíše nebo filtruje záznamy libovolného typu záznamu Raynetu. |
| RaynetGet | Přečte jeden záznam podle jeho id nebo podle Vašeho vlastního externího id. |
| RaynetDescribe | Zobrazí typy záznamů, jejich operace, sloupce pro filtrování a řazení, samostatná pole pro založení, úpravu a pojmenované založení s vyznačením povinných polí a hodnoty číselníků. |
| RaynetCreate | Založí záznam. |
| RaynetUpdate | Změní pole, která pošlete, u jednoho záznamu. Ostatní pole zůstanou beze změny. |
| RaynetDelete | Smaže jeden záznam. Vyžaduje potvrzení. |
| RaynetAction | Spustí akci nad záznamem, například uzamčení, sloučení nebo anonymizaci. Nevratné akce vyžadují potvrzení. |
| RaynetRequest | Odešle přímý požadavek na API. Ve výchozím stavu vypnuto. |
Práce jen pro čtení, například sub-agent, který smí pouze nahlížet, vidí jen RaynetSearch, RaynetGet a RaynetDescribe. Zapisovací nástroje před ním zůstanou skryté.
Před zápisem si asistent může zápis vyzkoušet nanečisto. Náhled ukáže přesný požadavek a nic neodešle. Potvrzení nepotřebuje, ale pořád ověří přístup, cestu, data i přihlašovací údaje. Skutečné mazání, nevratné akce a přímé zápisy stále vyžadují výslovný souhlas. Pole číselníků, jako je fáze, kategorie, měna nebo stav, berou číselná id, ne text. Platná id asistent zjistí nástrojem RaynetDescribe.
Raynet povoluje 24 000 požadavků denně pro celý účet. Když zbývá méně než 1000, asistent na to upozorní. Když se limit vyčerpá, asistent se zastaví a oznámí, kdy se obnoví — o půlnoci UTC.
Limity a náklady
- Denní kvóta Raynetu je 24 000 požadavků na účet a obnovuje se o půlnoci UTC. Plugin upozorní, když zbývá méně než 1000.
- Raynet povoluje čtyři souběžná připojení na instanci. Plugin drží v jednom procesu nejvýše dva požadavky souběžně.
- Každý požadavek má časový limit 30 sekund.
- Opakují se jen požadavky GET, a to pouze po odpovědi 429 způsobené příliš mnoha souběžnými připojeními, s čekáním 1 s a 4 s. Zápis se nikdy neopakuje, protože opakované založení by vytvořilo druhý záznam.
- Seznamy vracejí ve výchozím stavu 25 záznamů na stránku a jedno volání přijme nejvýše 1000.
- Filtry data ve formátu ISO se přepíšou na podobu, kterou Raynet přijímá. Jiný zápis data Raynet odmítne chybou.
- Výpisy číselníků ukazují prvních 200 hodnot seznamu kódů.
- Přímé požadavky jsou ve výchozím stavu vypnuté a jakýkoli zápis přes ně je odmítnut, dokud není režim přístupu plný.