Plugin WhatsApp
Plugin WhatsApp prepája Elowen s WhatsAppom. Nainštalujte ho v Nastavenia → Dostupné pluginy. Detail pluginu obsahuje jeho nastavenia, s panelom párovania na vlastnej karte. Inštalácia, zapnutie, vypnutie alebo zmena konfigurácie pluginu sa prejaví po reštarte Elowen; voľby pre jednotlivé chaty, napríklad model, platia okamžite. Každodenné príkazy a správanie kanála nájdete v časti WhatsApp. Spoločné pojmy pre všetky chatovacie platformy sú v prehľade Pluginy pre chatovacie platformy.
Pred aktualizáciou overte v manifeste a v trhovisku požiadavky na kompatibilné jadro a zdieľané/UI API; zvolené jadro musí obsahovať všetky funkcie hostiteľa, ktoré plugin používa.
Plugin môže inštalovať, zapínať a konfigurovať len administrátor. WhatsApp používa uloženú reláciu prepojeného zariadenia. Kým WhatsApp nie je spárovaný, nástroje pluginu vracajú chybu namiesto toho, aby niečo odoslali alebo prečítali.
Spárovanie a pripojenie
Nainštalujte a zapnite plugin WhatsApp, potom otvorte jeho panel Párovanie a zvoľte Spárovať zariadenie. Naskenujte QR kód vo WhatsAppe v časti Prepojené zariadenia → Prepojiť zariadenie. QR kód sa zobrazuje len v overenom nastavení párovania, nikdy v protokoloch. Ak chcete párovať telefónnym číslom, nastavte číslo bota v medzinárodnom formáte bez znamienka plus; osemznakový kód sa potom zobrazí len v overenom okne párovania. Zadajte tento kód vo WhatsAppe cez Prepojiť pomocou telefónneho čísla. Nastavte aspoň jedno pravidlo pre odosielateľa.
Príkazy zahŕňajú /new, ktorý v chate začne novú konverzáciu, a /help. /model a /reasoning otvárajú číslované ponuky modelu a úrovne uvažovania chatu. Len odosielateľ, ktorého pravidlo má nastavený admin, môže používať ponuky /model, /reasoning a /context alebo ovládacie príkazy /stop, /stats, /compact a /restart. /fast zapína alebo vypína rýchly režim pre váš účet a /project prepne konverzáciu do jedného z vašich Projektov; ani jedno nepotrebuje nastavenie operátora.
Plugin si spárovanú reláciu drží aj cez opakované pripojenia. Zachovaný odkaz neznamená, že aktuálne spojenie je pripravené: panel párovania zobrazuje zdieľaný stav pripojenia a dočasné výpadky prenosu skúša znova automaticky, bez pevného limitu pokusov. Nepárujte znova len preto, že je prepojený účet offline. Zvoľte Zrušiť párovanie a potvrďte, ak chcete požiadať o odhlásenie a vymazať miestny odkaz; nepotvrdené odhlásenie u poskytovateľa nie je zaručene úspešné. Zaregistrované odhlásenie vyžaduje výslovné nové spárovanie, kým vypršané prvé párovanie si ponecháva nedokončené prihlasovacie údaje. Výbery sa vykresľujú ako číslované textové stránky. Natívne formáty odpovedí s tlačidlami a zoznamami parser stále prijíma, ale nie sú vykresleným výstupom výberu.
Pravidlo pre odosielateľa rozhoduje, komu bot odpovedá, a môže pridať pokyny pre zdieľanú miestnosť. Nastavte aspoň jedno pravidlo. Platí prvé zodpovedajúce pravidlo. Pravidlo * pre všetkých sa vždy vyhodnocuje po pomenovaných pravidlách, nech je v zozname kdekoľvek, ale na konci udrží poradie prehľadné. Odosielateľ, ktorý nezodpovedá žiadnemu pravidlu, sa ignoruje. Pravidlo nenahrádza identitu: odosielateľ tiež potrebuje prepojený účet Elowen, ktorého prístup k Projektom a oprávnenia nástrojov platia pre dané kolo. Nastavenie admin v pravidle označí odosielateľa ako operátora. Zapne uvedené príkazy operátora a zdieľané pravidlá prístupu dajú danému kolu plný rozsah Projektov a celú sadu nástrojov pluginov v tejto dôveryhodnej konverzácii. Príznak operátora neudeľuje nástroje riadiacej roviny vlastníka.
Odpovede na otvorené otázky a číslované ponuky pred výberom možnosti alebo zmenou stránky kontrolujú aktuálne povolené skupiny a pravidlá pre odosielateľa. Odosielateľ, ktorý už nezodpovedá žiadnemu pravidlu, alebo skupina vylúčená zoznamom povolených nemôže odpovedať, ani keď je ponuka už otvorená. Oprávnená odpoveď na otvorenú otázku alebo ponuku nepotrebuje novú zmienku.
Voľby modelu a uvažovania sa potvrdia až po uložení nastavení. Neúspešné uloženie nevráti potvrdenie o úspechu.
Každý chat má vlastnú konverzáciu a môže mať vlastný model a úroveň uvažovania. Príkazom /new tam začnete novú konverzáciu. Obrázky sa posielajú nastavenému modelu pre obrázky; ak žiadny nie je nastavený, vybaví ich obvyklý model chatu.
Zadajte oznamovací chat, ak chcete dostávať proaktívne správy, napríklad výsledky naplánovaných úloh, eskalácie a oznámenia o reštarte. Nechajte ho prázdny, ak chcete tieto správy vypnúť.
Hlasové správy
Pošlite hlasovú správu a Elowen ju prepíše a odpovie textom a hlasovou poznámkou OGG/Opus. Hlas musí byť v Elowen zapnutý a odosielateľ potrebuje prepojený účet s oprávnením k hlasu a s rozpočtom pod limitom útraty. Rovnaké pravidlá platia v priamych chatoch aj v skupinách.
Prichádzajúci zvuk je obmedzený na 25 MiB. Väčší zvuk, odmietnutý prepis alebo chyba sťahovania či prepisu ponechá v konverzácii existujúcu poznámku o neprepísanej prílohe. Ak je hlas odmietnutý alebo zlyhá, textová odpoveď zostane.
Nastavenia hlasu a útratu spravuje Elowen. Plugin WhatsApp nemá samostatné nastavenie hlasového poskytovateľa.
Pripojenie a prístup
| Nastavenie | Čo robí |
|---|---|
| Telefónne číslo na párovanie | Voliteľné číslo bota v medzinárodnom formáte, bez +, medzier a pomlčiek. Po nastavení párovanie vyžiada osemznakový kód zobrazený v overenom okne párovania, takže zariadenie možno prepojiť telefónnym číslom; QR kód tam zostáva dostupný tiež. |
| Povolené skupiny | Voliteľné JID skupín; prázdne pole povolí skupiny, kde píše priradený odosielateľ. Priame chaty zostávajú povolené. |
| Oznamovací chat | Telefónne číslo alebo JID pre proaktívne správy; prázdne ich vypne. |
| Pravidlá pre odosielateľov | Priradí telefónne číslo, osobné JID alebo JID celej skupiny k prístupu a pokynom pre miestnosť. ID skupiny pustí dnu všetkých v tejto skupine. Pravidlo * sa vyhodnocuje posledné, nech je kdekoľvek. |
Kľúče polí v poradí tabuľky sú phoneNumber, groupIds, notifyChat a senderPolicies.
WhatsApp pri čítaní konfigurácie normalizuje zoradené pravidlá pre odosielateľov pomocou normalizeRolePolicies z elowen-plugin-shared/access. Orezáva identifikátory, odstraňuje presné duplicity identifikátorov a ponecháva prvé pravidlo, a zástupný znak radí na koniec. Normalizácia používa presnú rovnosť po orezaní; ekvivalenciu telefónu a JID počas prijímania stále vlastní samostatný párovač identity WhatsAppu. Chýbajúci zoznam je prázdny a sám o sebe nedáva odosielateľovi žiadny prístup. Spotrebiteľom je adaptér; nepridáva žiadnu požiadavku ani samostatné úložisko pravidiel.
Odpovede a médiá
| Nastavenie | Predvolené | Čo robí |
|---|---|---|
| Odpovedať aj bez zmienky | Zapnuté | Odpovedať v skupinách na každú správu priradeného odosielateľa; vypnite, ak chcete vyžadovať zmienku alebo odpoveď. Priame chaty dostanú odpoveď vždy. |
| Živý priebeh práce | Zapnuté | Upravovať správu s priebehom, kým agent pracuje; odpoveď sa pošle až na konci. |
| Nahradiť priebeh odpoveďou | Vypnuté | Nahradiť správu s priebehom finálnou odpoveďou. |
| Reakcie počas spracovania | Zapnuté | Zobrazovať stav spracovania ako reakcie na prichádzajúcej správe. |
| Stavový riadok | Zapnuté | Pridať pod odpoveď model a využitie kontextu. |
| Zobraziť uvažovanie | Vypnuté | Zobraziť výstup rozšíreného uvažovania, ak ho model podporuje. |
| Jazyk služobných správ | Angličtina | Jazyk služobných správ: angličtina, čeština alebo slovenčina. |
| Model pre obrázky | Nenastavené | Model pre správy s obrázkom; prázdne pole použije obvyklý model chatu. |
| Max. veľkosť prichádzajúceho obrázka | 5 MiB | Limit sťahovania od 1 do 20 MiB; väčšie obrázky sa len zaznamenajú. |
| Max. obrázkov v odpovedi | 4 | Obrázky zdieľané cez ShareImage pripojené k jednej odpovedi, od 1 do 10. |
| Časový limit ponuky | 6 minút | Čas na výber z interaktívnej ponuky, od 30 sekúnd do 30 minút v krokoch po 30 sekundách. |
Ak zdieľaný obrázok alebo súbor nemožno doručiť, plugin sa na danej položke zastaví: zostávajúce položky ani text odpovede sa neodošlú a chat namiesto toho dostane oznámenie o zlyhaní. Popisok a citovaná správa patria len k prvému obrázku. Súbory, ktoré agent zdieľa, sa posielajú ako dokumenty, ktoré si zachovajú názvy, najviac štyri na odpoveď a 25 MiB každý; väčší súbor sa neodošle.
Interaktívne otázky zobrazia najviac štyri otázky na správu, každú až s 25 možnosťami. Číslované ponuky zobrazujú 18 položiek na stránku, s číslovanými riadkami Predchádzajúce a Ďalšie, ak je strán viac.
Kľúče v poradí tabuľky sú respondWithoutMention, streaming, deleteToolActivityAfterTurn, reactions, runtimeFooter, showReasoning, language, visionModel, maxImageBytes, maxUploadImages a askTimeoutMs.
Nástroje a oprávnenia
Spárovaný účet musí byť administrátorom skupiny, aby mohol pridávať alebo odoberať členov. WhatsappGroupList vracia JID skupín pre ostatné skupinové nástroje; WhatsappGroupInfo zobrazuje účastníkov a administrátorov skupiny. Šesť nástrojov je WhatsappGroupList, WhatsappGroupInfo, WhatsappSend, WhatsappGroupCreate, WhatsappGroupAdd a WhatsappGroupRemove; nástroj pre surové API neexistuje.
WhatsappSend posiela prostý text na ľubovoľné telefónne číslo, používateľské JID alebo JID skupiny, na ktoré účet dosiahne, nielen do chatu, v ktorom ste. Vracia krátke potvrdenie s rozlíšeným JID, nie ID správy. Správy odoslané cez WhatsappSend nemožno odvolať, preto pred odoslaním skontrolujte príjemcu. Odobratie člena sa v skupine oznámi. Vytvorenie skupiny potrebuje aspoň jedného platného člena a čísla neregistrované vo WhatsAppe môžu byť ticho vynechané. WhatsappGroupAdd a WhatsappGroupRemove vracajú surový výsledok pre každého účastníka, kde nenulový stav znamená, že WhatsApp danú osobu odmietol. Bot sám ignoruje správy z newsletterov a zoznamov na vysielanie. Dlhé odpovede sa delia na správy do 4 000 znakov.