Plugin WhatsApp
Plugin WhatsApp propojuje Elowen s WhatsAppem. Nainstalujte ho v Nastavení → Dostupné pluginy. Detail pluginu obsahuje jeho nastavení, s panelem párování na vlastní kartě. Instalace, zapnutí, vypnutí nebo změna konfigurace pluginu se projeví po restartu Elowen; volby pro jednotlivé chaty, například model, platí okamžitě. Každodenní příkazy a chování kanálu najdete v části WhatsApp. Společné pojmy pro všechny chatovací platformy jsou v přehledu Pluginy pro chatovací platformy.
Před aktualizací ověřte v manifestu a v tržišti požadavky na kompatibilní jádro a sdílené/UI API; zvolené jádro musí obsahovat všechny funkce hostitele, které plugin používá.
Plugin může instalovat, zapínat a konfigurovat jen administrátor. WhatsApp používá uloženou relaci propojeného zařízení. Dokud WhatsApp není spárovaný, nástroje pluginu vracejí chybu, místo aby něco odeslaly nebo přečetly.
Spárování a připojení
Nainstalujte a zapněte plugin WhatsApp, pak otevřete jeho panel Párování a zvolte Spárovat zařízení. Naskenujte QR kód ve WhatsAppu v části Propojená zařízení → Propojit zařízení. QR kód se zobrazuje jen v ověřeném nastavení párování, nikdy v protokolech. Chcete-li párovat telefonním číslem, nastavte číslo bota v mezinárodním formátu bez znaménka plus; osmiznakový kód se pak zobrazí jen v ověřeném okně párování. Zadejte tento kód ve WhatsAppu přes Propojit pomocí telefonního čísla. Nastavte alespoň jedno pravidlo pro odesílatele.
Příkazy zahrnují /new, který v chatu začne novou konverzaci, a /help. /model a /reasoning otevírají číslované nabídky modelu a úrovně uvažování chatu. Jen odesílatel, jehož pravidlo má nastavený admin, může používat nabídky /model, /reasoning a /context nebo ovládací příkazy /stop, /stats, /compact a /restart. /fast zapíná nebo vypíná rychlý režim pro váš účet a /project přepne konverzaci do jednoho z vašich Projektů; ani jedno nepotřebuje nastavení operátora.
Plugin si spárovanou relaci drží i přes opakovaná připojení. Zachovaný odkaz neznamená, že aktuální spojení je připravené: panel párování ukazuje sdílený stav připojení a dočasné výpadky přenosu zkouší znovu automaticky, bez pevného limitu pokusů. Nepárujte znovu jen proto, že je propojený účet offline. Zvolte Zrušit párování a potvrďte, chcete-li požádat o odhlášení a vymazat místní odkaz; nepotvrzené odhlášení u poskytovatele není zaručeně úspěšné. Zaregistrované odhlášení vyžaduje výslovné nové spárování, zatímco vypršelé první párování si ponechává nedokončené přihlašovací údaje. Výběry se vykreslují jako číslované textové stránky. Nativní formáty odpovědí s tlačítky a seznamy parser stále přijímá, ale nejsou vykresleným výstupem výběru.
Pravidlo pro odesílatele rozhoduje, komu bot odpovídá, a může přidat pokyny pro sdílenou místnost. Nastavte alespoň jedno pravidlo. Platí první odpovídající pravidlo. Pravidlo * pro všechny se vždy vyhodnocuje po pojmenovaných pravidlech, ať je v seznamu kdekoli, ale na konci udrží pořadí přehledné. Odesílatel, který neodpovídá žádnému pravidlu, se ignoruje. Pravidlo nenahrazuje identitu: odesílatel také potřebuje propojený účet Elowen, jehož přístup k Projektům a oprávnění nástrojů platí pro dané kolo. Nastavení admin v pravidle označí odesílatele jako operátora. Zapne uvedené příkazy operátora a sdílená pravidla přístupu dají danému kolu plný rozsah Projektů a celou sadu nástrojů pluginů v této důvěryhodné konverzaci. Příznak operátora neuděluje nástroje řídicí roviny vlastníka.
Odpovědi na otevřené otázky a číslované nabídky před výběrem možnosti nebo změnou stránky kontrolují aktuální povolené skupiny a pravidla pro odesílatele. Odesílatel, který už neodpovídá žádnému pravidlu, nebo skupina vyloučená seznamem povolených nemůže odpovědět, ani když je nabídka už otevřená. Oprávněná odpověď na otevřenou otázku nebo nabídku nepotřebuje novou zmínku.
Volby modelu a uvažování se potvrdí až po uložení nastavení. Neúspěšné uložení nevrátí potvrzení o úspěchu.
Každý chat má vlastní konverzaci a může mít vlastní model a úroveň uvažování. Příkazem /new tam začnete novou konverzaci. Obrázky se posílají nastavenému modelu pro obrázky; pokud žádný není nastavený, vyřídí je obvyklý model chatu.
Zadejte oznamovací chat, pokud chcete dostávat proaktivní zprávy, například výsledky naplánovaných úloh, eskalace a oznámení o restartu. Nechte ho prázdný, chcete-li tyto zprávy vypnout.
Hlasové zprávy
Pošlete hlasovou zprávu a Elowen ji přepíše a odpoví textem a hlasovou poznámkou OGG/Opus. Hlas musí být v Elowen zapnutý a odesílatel potřebuje propojený účet s oprávněním k hlasu a s rozpočtem pod limitem útraty. Stejná pravidla platí v přímých chatech i ve skupinách.
Příchozí zvuk je omezen na 25 MiB. Větší zvuk, odmítnutý přepis nebo chyba stahování či přepisu ponechá v konverzaci stávající poznámku o nepřepsané příloze. Pokud je hlas odmítnut nebo selže, textová odpověď zůstane.
Nastavení hlasu a útratu spravuje Elowen. Plugin WhatsApp nemá samostatné nastavení hlasového poskytovatele.
Připojení a přístup
| Nastavení | Co dělá |
|---|---|
| Telefonní číslo pro párování | Volitelné číslo bota v mezinárodním formátu, bez +, mezer a pomlček. Po nastavení párování vyžádá osmiznakový kód zobrazený v ověřeném okně párování, takže zařízení lze propojit telefonním číslem; QR kód tam zůstává dostupný také. |
| Povolené skupiny | Volitelná JID skupin; prázdné pole povolí skupiny, kde píše přiřazený odesílatel. Přímé chaty zůstávají povolené. |
| Oznamovací chat | Telefonní číslo nebo JID pro proaktivní zprávy; prázdné je vypne. |
| Pravidla pro odesílatele | Přiřadí telefonní číslo, osobní JID nebo JID celé skupiny k přístupu a pokynům pro místnost. ID skupiny pustí dovnitř všechny v této skupině. Pravidlo * se vyhodnocuje poslední, ať je kdekoli. |
Klíče polí v pořadí tabulky jsou phoneNumber, groupIds, notifyChat a senderPolicies.
WhatsApp při čtení konfigurace normalizuje seřazená pravidla pro odesílatele pomocí normalizeRolePolicies z elowen-plugin-shared/access. Ořezává identifikátory, odstraňuje přesné duplicity identifikátorů a ponechává první pravidlo, a zástupný znak řadí na konec. Normalizace používá přesnou rovnost po oříznutí; ekvivalenci telefonu a JID během přijímání stále vlastní samostatný párovač identity WhatsAppu. Chybějící seznam je prázdný a sám o sobě nedává odesílateli žádný přístup. Spotřebitelem je adaptér; nepřidává žádný požadavek ani samostatné úložiště pravidel.
Odpovědi a média
| Nastavení | Výchozí | Co dělá |
|---|---|---|
| Odpovídat i bez zmínky | Zapnuto | Odpovídat ve skupinách na každou zprávu přiřazeného odesílatele; vypněte, chcete-li vyžadovat zmínku nebo odpověď. Přímé chaty dostanou odpověď vždy. |
| Živý průběh práce | Zapnuto | Upravovat zprávu s průběhem, dokud agent pracuje; odpověď se pošle až na konci. |
| Nahradit průběh odpovědí | Vypnuto | Nahradit zprávu s průběhem finální odpovědí. |
| Reakce během zpracování | Zapnuto | Zobrazovat stav zpracování jako reakce na příchozí zprávě. |
| Stavový řádek | Zapnuto | Přidat pod odpověď model a využití kontextu. |
| Zobrazit uvažování | Vypnuto | Zobrazit výstup rozšířeného uvažování, pokud ho model podporuje. |
| Jazyk služebních zpráv | Angličtina | Jazyk služebních zpráv: angličtina, čeština nebo slovenština. |
| Model pro obrázky | Nenastaveno | Model pro zprávy s obrázkem; prázdné pole použije obvyklý model chatu. |
| Max. velikost příchozího obrázku | 5 MiB | Limit stahování od 1 do 20 MiB; větší obrázky se jen zaznamenají. |
| Max. obrázků v odpovědi | 4 | Obrázky sdílené přes ShareImage připojené k jedné odpovědi, od 1 do 10. |
| Časový limit nabídky | 6 minut | Doba na výběr z interaktivní nabídky, od 30 sekund do 30 minut v krocích po 30 sekundách. |
Pokud sdílený obrázek nebo soubor nelze doručit, plugin se na dané položce zastaví: zbývající položky ani text odpovědi se neodešlou a chat místo toho dostane oznámení o selhání. Popisek a citovaná zpráva patří jen k prvnímu obrázku. Soubory, které agent sdílí, se posílají jako dokumenty, které si zachovají názvy, nejvýše čtyři na odpověď a 25 MiB každý; větší soubor se neodešle.
Interaktivní otázky zobrazí nejvýše čtyři otázky na zprávu, každou až s 25 možnostmi. Číslované nabídky zobrazují 18 položek na stránku, s číslovanými řádky Předchozí a Další, pokud je stránek víc.
Klíče v pořadí tabulky jsou respondWithoutMention, streaming, deleteToolActivityAfterTurn, reactions, runtimeFooter, showReasoning, language, visionModel, maxImageBytes, maxUploadImages a askTimeoutMs.
Nástroje a oprávnění
Spárovaný účet musí být administrátorem skupiny, aby mohl přidávat nebo odebírat členy. WhatsappGroupList vrací JID skupin pro ostatní skupinové nástroje; WhatsappGroupInfo ukazuje účastníky a administrátory skupiny. Šest nástrojů je WhatsappGroupList, WhatsappGroupInfo, WhatsappSend, WhatsappGroupCreate, WhatsappGroupAdd a WhatsappGroupRemove; nástroj pro surové API neexistuje.
WhatsappSend posílá prostý text na libovolné telefonní číslo, uživatelské JID nebo JID skupiny, na které účet dosáhne, nejen do chatu, ve kterém jste. Vrací krátké potvrzení s rozlišeným JID, ne ID zprávy. Zprávy odeslané přes WhatsappSend nelze odvolat, proto před odesláním zkontrolujte příjemce. Odebrání člena se ve skupině oznámí. Vytvoření skupiny potřebuje alespoň jednoho platného člena a čísla neregistrovaná ve WhatsAppu mohou být tiše vynechána. WhatsappGroupAdd a WhatsappGroupRemove vracejí surový výsledek pro každého účastníka, kde nenulový stav znamená, že WhatsApp danou osobu odmítl. Bot sám ignoruje zprávy z newsletterů a seznamů pro vysílání. Dlouhé odpovědi se dělí na zprávy do 4 000 znaků.