Raynet
Plugin Raynet prepája Elowen s Raynet CRM cez Raynet API v2. Asistent získa nástroje na vyhľadávanie, čítanie, zakladanie, úpravy a mazanie záznamov Raynetu aj na akcie nad nimi — napríklad klientov, obchodné prípady, ponuky a aktivity. Plugin tiež pridá do ľavého menu stránku Raynet, kde si môžete CRM prehliadať a prihlásiť sa vlastným účtom Raynetu.
Všetci pracujú pod firemným účtom Raynetu, ktorý nastaví administrátor, pokiaľ si niekto nezapne vlastné údaje.
Inštalácia
- Otvorte Nastavenia → Dostupné pluginy a nainštalujte Raynet. Obchod ponúka iba pluginy, ktoré Vaša licencia povoľuje.
- Otvorte Nastavenia → Prístupy → Raynet a vyplňte Názov inštancie, Firemné používateľské meno a Firemný API kľúč.
- V nastaveniach pluginu v časti Nastavenia → Pluginy zvoľte Režim prístupu a Povoliť priame požiadavky nechajte vypnuté, kým ich nepotrebujete.
- Prideľte plugin každému, kto ho má používať. Otvorte Používatelia, vyberte účet a použite Spravovať pridelené pluginy.
Aktuálnu verziu pluginu a jeho minimálnu verziu Elowen nájdete v registri.
Nastavenia administrátora
Tri polia s prihlasovacími údajmi nájdete v Nastavenia → Prístupy → Raynet; polia s pravidlami sú v nastaveniach pluginu v časti Nastavenia → Pluginy.
| Nastavenie | Predvolená hodnota | Čo robí |
|---|---|---|
| Názov inštancie | Povinné, bez predvolenej hodnoty | Názov Vašej inštancie Raynetu malými písmenami presne tak, ako ho Raynet píše. Na nesprávny názov odpovie „Instance not found“, nie chybou prihlásenia. Platí pre všetkých. |
| Firemné používateľské meno | Prázdne | Prihlásenie do Raynetu, pod ktorým pracujú všetci, čo si nezapli vlastné údaje. Použijú ho aj behy bez obsluhy, napríklad naplánovaná úloha bez vlastníka alebo webhook. |
| Firemný API kľúč | Prázdny | API kľúč firemného prihlásenia (v Raynete: Používateľské nastavenia → API kľúč). Ukladá sa na serveri a znova sa nezobrazí. |
| Povoliť vlastné prihlasovacie údaje | Zapnuté | Umožní používateľovi prepnúť sa na vlastné prihlásenie do Raynetu, aby sa jeho práca pripisovala jemu. Keď je vypnuté, pracujú všetci pod firemným účtom a uložené osobné údaje sa ignorujú. |
| Režim prístupu | Čítanie a zápis (vrátane mazania) | Určuje, čo smie asistent v CRM robiť. Podrobnosti nižšie. |
| Povoliť priame požiadavky | Vypnuté | Zapne nástroj RaynetRequest, ktorý dokáže zavolať ľubovoľný endpoint API. |
Režim prístupu obmedzuje, čo smie jeden ťah v CRM urobiť:
- Iba čítanie: asistent môže záznamy vyhľadávať a čítať.
- Čítanie a zápis (vrátane mazania): asistent môže navyše zakladať a upravovať záznamy a zmazať jeden záznam.
- Plný (vrátane zlučovania a anonymizácie): asistent môže navyše zlučovať a anonymizovať záznamy a spúšťať ďalšie operácie, ktoré sa nedajú vrátiť.
Každá nevratná operácia navyše vyžaduje výslovné potvrdenie vo volaní nástroja. Priame požiadavky zostávajú vypnuté, kým ich administrátor nezapne, a priamy zápis vyžaduje plný režim.
Práca so stránkou Raynet
- Kliknite na Raynet v ľavom menu. Hlavička ukazuje inštanciu, počet typov záznamov, zostávajúce požiadavky na dnešný deň a čo asistent smie.
- V poli Typ záznamu vyberte typ záznamu; jeho najnovšie záznamy sa zobrazia hneď. Zadaním do vyhľadávacieho poľa a kliknutím na Hľadať ich zúžite. Bez hľadaného textu radí Raynet zoznam od najnovšieho.
- Kliknutím na záhlavie stĺpca, ktoré je tlačidlom, zoradíte podľa tohto stĺpca. Medzi stránkami sa pohybujete tlačidlami Späť a Ďalej.
- Kliknutím na riadok otvoríte vedľa zoznamu Detail. Skryjete ho tlačidlom Zavrieť.
Ak ešte nie ste prihlásení, stránka zobrazí skupinu Prihlásenie do Raynetu, ktorá je na začiatku zbalená. Otvorte ju a podľa týchto krokov budete pracovať pod vlastným prihlásením:
- Zapnite Používať vlastné prihlásenie do Raynetu.
- Zadajte Používateľské meno a API kľúč. Kľúč nájdete v Raynete v Používateľské nastavenia → API kľúč.
- Kliknite na Uložiť a overiť pripojenie. Stránka potom oznámi, či Raynet prihlásenie prijal.
Nechajte pole API kľúč prázdne, ak chcete zachovať kľúč, ktorý už máte uložený. Ak sa chcete vrátiť k firemnému účtu, vypnite Používať vlastné prihlásenie do Raynetu a uložte. Uložený kľúč zostane na mieste. Overiť uložené údaje zopakuje overenie pripojenia bez toho, aby čokoľvek ukladalo.
Ak vyhľadávanie nič nenájde, stránka zobrazí Nič sa nenašlo. Ak sa Raynet nedá dosiahnuť, zobrazí Dáta z Raynetu sa nepodarilo načítať s tlačidlom na opakovanie.
Nástroje Raynetu pre asistenta
| Nástroj | Čo robí |
|---|---|
| RaynetSearch | Vypíše alebo filtruje záznamy ľubovoľného typu záznamu Raynetu. |
| RaynetGet | Prečíta jeden záznam podľa jeho id alebo podľa Vášho vlastného externého id. |
| RaynetDescribe | Zobrazí typy záznamov, ich operácie, stĺpce na filtrovanie a zoraďovanie, samostatné polia na založenie, úpravu a pomenované založenie s vyznačením povinných polí a hodnoty číselníkov. |
| RaynetCreate | Založí záznam. |
| RaynetUpdate | Zmení polia, ktoré pošlete, pri jednom zázname. Ostatné polia zostanú bez zmeny. |
| RaynetDelete | Zmaže jeden záznam. Vyžaduje potvrdenie. |
| RaynetAction | Spustí akciu nad záznamom, napríklad uzamknutie, zlúčenie alebo anonymizáciu. Nevratné akcie vyžadujú potvrdenie. |
| RaynetRequest | Odošle priamu požiadavku na API. Predvolene vypnuté. |
Práca iba na čítanie, napríklad sub-agent, ktorý smie iba nazerať, vidí len RaynetSearch, RaynetGet a RaynetDescribe. Zapisovacie nástroje pred ním zostanú skryté.
Pred zápisom si asistent môže zápis vyskúšať naprázdno. Náhľad ukáže presnú požiadavku a nič neodošle. Potvrdenie nepotrebuje, ale stále overí prístup, cestu, dáta aj prihlasovacie údaje. Skutočné mazanie, nevratné akcie a priame zápisy stále vyžadujú výslovný súhlas. Polia číselníkov, ako je fáza, kategória, mena alebo stav, berú číselné id, nie text. Platné id asistent zistí nástrojom RaynetDescribe.
Raynet povoľuje 24 000 požiadaviek denne pre celý účet. Keď zostáva menej ako 1000, asistent na to upozorní. Keď sa limit vyčerpá, asistent sa zastaví a oznámi, kedy sa obnoví — o polnoci UTC.
Limity a náklady
- Denná kvóta Raynetu je 24 000 požiadaviek na účet a obnovuje sa o polnoci UTC. Plugin upozorní, keď zostáva menej ako 1000.
- Raynet povoľuje štyri súbežné pripojenia na inštanciu. Plugin drží v jednom procese najviac dve požiadavky súbežne.
- Každá požiadavka má časový limit 30 sekúnd.
- Opakujú sa iba požiadavky GET, a to len po odpovedi 429 spôsobenej príliš mnohými súbežnými pripojeniami, s čakaním 1 s a 4 s. Zápis sa nikdy neopakuje, pretože opakované založenie by vytvorilo druhý záznam.
- Zoznamy vracajú predvolene 25 záznamov na stránku a jedno volanie prijme najviac 1000.
- Filtre dátumu vo formáte ISO sa prepíšu na podobu, ktorú Raynet prijíma. Iný zápis dátumu Raynet odmietne chybou.
- Výpisy číselníkov ukazujú prvých 200 hodnôt zoznamu kódov.
- Priame požiadavky sú predvolene vypnuté a akýkoľvek zápis cez ne je odmietnutý, kým nie je režim prístupu plný.