Plugin WhatsApp nastavíte v Nastavenia → Pluginy → WhatsApp. Prepája jeden účet WhatsApp s Elowen; najprv účet spárujte a potom nastavte pravidlá pre odosielateľov.
O zdieľanej identite a pravidlách konverzácie sa dočítate v článku Kanály.
Spárovanie účtu
- Zapnite plugin a otvorte jeho panel Párovanie.
- Zvoľte Spárovať zariadenie.
- Naskenujte QR kód z WhatsAppu v ponuke Prepojené zariadenia → Prepojiť zariadenie. Ak chcete namiesto toho použiť párovací kód telefónu, nastavte Telefónne číslo na párovanie na medzinárodné číslo bota zapísané len číslicami. Plugin zobrazí kód s ôsmimi znakmi, ktorý zadáte v Prepojené zariadenia → Prepojiť pomocou telefónneho čísla.
- Pridajte aspoň jedno pravidlo pre odosielateľa.
Panel zobrazuje aktuálny kód a stav pripojenia. Voľbou Nový kód získate nový kód. Prihlasovacie údaje zostávajú pre opätovné pripojenie. Zrušiť párovanie odhlási prepojené zariadenie a odstráni jeho lokálne údaje; pre ďalšie pripojenie ho spárujte znova.
Kto smie bota používať
Pravidlá nastavte v Nastavenia → Pluginy → WhatsApp → Pravidlá pre odosielateľov. Vyhráva prvé zodpovedajúce pravidlo; odosielatelia bez zhody sa ignorujú. Pravidlo môže zodpovedať telefónnemu číslu, osobnému JID končiacemu na @s.whatsapp.net, JID celej skupiny končiacemu na @g.us alebo * ako záverečné pravidlo pre všetkých. * dajte na koniec. Zhoda čísel ignoruje formátovanie, takže 420777123456, +420 777 123 456 aj jeho osobné JID zodpovedajú rovnakému odosielateľovi.
WhatsApp môže niekoho identifikovať interným JID @lid. Ak Baileys poskytne zodpovedajúce telefónne JID, plugin ho použije; inak je LID samostatná identita a nepočíta sa ako prepojenie s telefónnym číslom.
Voľbou Prístup administrátora pri pravidle povolíte ovládanie spoločného chatu. Neudeľuje prístup k Projektom ani nástrojom: tie sa riadia prepojeným účtom Elowen odosielateľa a jeho oprávneniami k nástrojom. Nástroje na správu skupín navyše obmedzujú práva spárovaného účtu WhatsApp, napríklad jeho rola v skupine.
Priame chaty a skupiny
Priame chaty sú konverzácie jedného človeka a nepotrebujú zmienku. V skupinách bot každého odosielateľa páruje podľa jeho osobného identifikátora; pravidlo pre celú skupinu môže vpustiť všetkých v danej skupine.
Odpovedať bez zmienky je v predvolenom nastavení zapnuté, takže bot v skupine odpovedá na každú správu od vpusteného odosielateľa. Vypnutím vynútite @zmienku alebo odpoveď botovi. Povolené skupiny môžu obmedziť odpovede na uvedené JID skupín; prázdne pole povolí každú skupinu, kde píše vpustený odosielateľ. Priame chaty zostávajú dostupné.
Príkazy a otázky
WhatsApp používa číslované textové prompty namiesto natívnych tlačidiel. AskUserQuestion môže obsahovať až štyri otázky, každú s dvoma až štyrmi voľbami. Každá odpoveď zodpovie prvú nezodpovedanú otázku. Číslo zvolí danú voľbu a čiarkami oddelené čísla vyberú niekoľko volieb pri otázke s viacerými voľbami. Iný text sa považuje za Vašu vlastnú odpoveď, ak to otázka nezakazuje. Odpovede sa odošlú, keď má každá otázka svoju; ak je doručenie odmietnuté, odpovedzte submit a skúste to znova. Odpovedať môže len oslovený človek. Otázky zostávajú zodpovedateľné, kým Elowen odpoveď neprijme alebo čakajúcu otázku nevyrieši. Časový limit ponuky riadi len číslované ponuky príkazov: v predvolenom nastavení šesť minút, nastaviteľný od 30 sekúnd do 30 minút. Zrušené otázky a vypršané ponuky nemôžu spotrebovať neskoršiu číselnú odpoveď.
| Príkaz | Účel |
|---|---|
/model, /reasoning, /context |
Otvoria číslované ponuky. |
/new, /stop, /stats, /compact |
Spravujú konverzáciu. |
/fast |
Zapne alebo vypne Fast pre vybraný model chatu vo vlastnej voľbe prepojeného účtu: on, off alebo status. |
/project |
Prepne túto konverzáciu do jedného z Vašich Projektov. |
/plan, /build, /workflow |
Prepnú pracovný režim konverzácie; len pre administrátorov. |
/restart |
Reštartuje démona; len pre administrátorov. |
/help |
Zobrazí príkazy dostupné odosielateľovi. |
Ponuky modelu, uvažovania a kontextu a príkazy /plan, /build a /workflow vyžadujú pravidlo administrátora. /stop, /stats a /compact tiež. /fast vyžaduje prepojený účet. WhatsApp nemá príkaz /display.
Živý priebeh, oznámenia a obrázky
Živý priebeh práce je v predvolenom nastavení zapnutý: plugin počas práce agenta aktualizuje jednu správu s priebehom a finálnu odpoveď potom pošle zvlášť. Vypnutím zobrazíte len odpoveď. Nahradiť priebeh odpoveďou je v predvolenom nastavení vypnuté; po zapnutí sa správa s priebehom nahradí odpoveďou, nezmaže sa.
Reakcie počas spracovania (👀, ✅, ❌) sú v predvolenom nastavení zapnuté; vypnutím Reakcie počas spracovania ich zrušíte. Chat na oznámenia volí cieľ pre proaktívne výsledky cron a tick úloh, eskalácie a oznámenia o reštarte. Prijíma telefónne číslo, osobné JID alebo JID skupiny; samotné čísla sa prevedú na @s.whatsapp.net. Výslovný cieľ dodaný hostiteľom má prednosť. Ak pole necháte prázdne, tieto správy sa vypnú; oznámenia obchádzajú pravidlá pre odosielateľov, ale účet musí byť spárovaný.
Hlasové správy sa prepisujú, keď je v Elowen zapnutý hlas a odosielateľ má prepojený účet s oprávnením na hlas a priestorom v rámci limitu útraty. Elowen odpovie textom a hlasovou správou v OGG/Opus. Prichádzajúci zvuk je obmedzený na 25 MiB. Väčší zvuk, odmietnutý prepis a chyby pri sťahovaní či prepise zanechajú poznámku o neprepísanej prílohe. Ak je reč odmietnutá alebo zlyhá, textová odpoveď zostane. Hlas sa nastavuje v Elowen; plugin WhatsApp nemá vlastné nastavenie poskytovateľa hlasu.
Na spracovanie obrázkov nastavte Model pre obrázky na model s podporou zraku, alebo pole nechajte prázdne a použije sa model chatu. Každá prichádzajúca správa nesie najviac jeden obrázok. Max. veľkosť prichádzajúceho obrázka obmedzuje veľkosť jeho stiahnutia a v predvolenom nastavení je 5 MiB; väčšie obrázky sa zmenia na poznámku o prílohe. Max. obrázkov na odpoveď obmedzuje zdieľané obrázky v odchádzajúcej odpovedi, v predvolenom nastavení je 4, nastaviť možno 1 až 10.