Plugin WhatsApp nastavíte v Nastavení → Pluginy → WhatsApp. Propojuje jeden účet WhatsApp s Elowen; nejdřív účet spárujte a potom nastavte pravidla pro odesílatele.
O sdílené identitě a pravidlech konverzace se dočtete v článku Kanály.
Spárování účtu
- Zapněte plugin a otevřete jeho panel Párování.
- Zvolte Spárovat zařízení.
- Naskenujte QR kód z WhatsAppu v nabídce Propojená zařízení → Propojit zařízení. Pokud chcete místo toho použít párovací kód telefonu, nastavte Telefonní číslo pro párování na mezinárodní číslo bota zapsané jen číslicemi. Plugin zobrazí kód o osmi znacích, který zadáte v Propojená zařízení → Propojit pomocí telefonního čísla.
- Přidejte alespoň jedno pravidlo pro odesílatele.
Panel zobrazuje aktuální kód a stav připojení. Volbou Nový kód získáte nový kód. Přihlašovací údaje zůstávají pro opětovné připojení. Zrušit párování odhlásí propojené zařízení a odstraní jeho místní údaje; pro další připojení ho spárujte znovu.
Kdo smí bota používat
Pravidla nastavte v Nastavení → Pluginy → WhatsApp → Pravidla pro odesílatele. Vyhrává první odpovídající pravidlo; odesílatelé bez shody jsou ignorováni. Pravidlo může odpovídat telefonnímu číslu, osobnímu JID končícímu na @s.whatsapp.net, JID celé skupiny končícímu na @g.us nebo * jako závěrečné pravidlo pro všechny. * dejte na konec. Shoda čísel ignoruje formátování, takže 420777123456, +420 777 123 456 i jeho osobní JID odpovídají stejnému odesílateli.
WhatsApp může někoho identifikovat interním JID @lid. Pokud Baileys poskytne odpovídající telefonní JID, plugin ho použije; jinak je LID samostatná identita a nepočítá se jako propojení s telefonním číslem.
Volbou Přístup administrátora u pravidla povolíte ovládání společného chatu. Neuděluje přístup k Projektům ani nástrojům: ty se řídí propojeným účtem Elowen odesílatele a jeho oprávněními k nástrojům. Nástroje pro správu skupin navíc omezují práva spárovaného účtu WhatsApp, například jeho role ve skupině.
Přímé chaty a skupiny
Přímé chaty jsou konverzace jednoho člověka a nepotřebují zmínku. Ve skupinách bot každého odesílatele páruje podle jeho osobního identifikátoru; pravidlo pro celou skupinu může vpustit všechny v dané skupině.
Odpovídat i bez zmínky je ve výchozím nastavení zapnuté, takže bot ve skupině odpovídá na každou zprávu od vpuštěného odesílatele. Vypnutím vynutíte @zmínku nebo odpověď botovi. Povolené skupiny mohou omezit odpovědi na uvedená JID skupin; prázdné pole povolí každou skupinu, kde píše vpuštěný odesílatel. Přímé chaty zůstávají dostupné.
Příkazy a otázky
WhatsApp používá číslované textové prompty místo nativních tlačítek. AskUserQuestion může obsahovat až čtyři otázky, každou se dvěma až čtyřmi volbami. Každá odpověď zodpoví první nezodpovězenou otázku. Číslo zvolí danou volbu a čárkami oddělená čísla vyberou několik voleb u otázky s více volbami. Jiný text se považuje za Vaši vlastní odpověď, pokud to otázka nezakazuje. Odpovědi se odešlou, jakmile má každá otázka svou; pokud je doručení odmítnuto, odpovězte submit a zkuste to znovu. Odpovědět může jen oslovený člověk. Otázky zůstávají zodpověditelné, dokud Elowen odpověď nepřijme nebo čekající otázku nevyřeší. Časový limit nabídky řídí jen číslované nabídky příkazů: ve výchozím nastavení šest minut, nastavitelný od 30 sekund do 30 minut. Zrušené otázky a vypršené nabídky nemohou spotřebovat pozdější číselnou odpověď.
| Příkaz | Účel |
|---|---|
/model, /reasoning, /context |
Otevřou číslované nabídky. |
/new, /stop, /stats, /compact |
Spravují konverzaci. |
/fast |
Zapne nebo vypne Fast pro vybraný model chatu ve vlastní volbě propojeného účtu: on, off nebo status. |
/project |
Přepne tuto konverzaci do jednoho z Vašich Projektů. |
/plan, /build, /workflow |
Přepnou pracovní režim konverzace; jen pro administrátory. |
/restart |
Restartuje démona; jen pro administrátory. |
/help |
Zobrazí příkazy dostupné odesílateli. |
Nabídky modelu, uvažování a kontextu a příkazy /plan, /build a /workflow vyžadují pravidlo administrátora. /stop, /stats a /compact také. /fast vyžaduje propojený účet. WhatsApp nemá příkaz /display.
Živý průběh, oznámení a obrázky
Živý průběh práce je ve výchozím nastavení zapnutý: plugin během práce agenta aktualizuje jednu zprávu s průběhem a finální odpověď pak pošle zvlášť. Vypnutím zobrazíte jen odpověď. Nahradit průběh odpovědí je ve výchozím nastavení vypnuté; po zapnutí se zpráva s průběhem nahradí odpovědí, nesmaže se.
Reakce během zpracování (👀, ✅, ❌) jsou ve výchozím nastavení zapnuté; vypnutím Reakce během zpracování je zrušíte. Chat pro oznámení volí cíl pro proaktivní výsledky cron a tick úloh, eskalace a oznámení o restartu. Přijímá telefonní číslo, osobní JID nebo JID skupiny; samotná čísla se převedou na @s.whatsapp.net. Výslovný cíl dodaný hostitelem má přednost. Ponecháte-li pole prázdné, tyto zprávy se vypnou; oznámení obcházejí pravidla pro odesílatele, ale účet musí být spárovaný.
Hlasové zprávy se přepisují, když je v Elowen zapnutý hlas a odesílatel má propojený účet s oprávněním k hlasu a prostorem v rámci limitu útraty. Elowen odpoví textem a hlasovou zprávou v OGG/Opus. Příchozí zvuk je omezen na 25 MiB. Větší zvuk, odmítnutý přepis a chyby při stahování či přepisu zanechají poznámku o nepřepsané příloze. Pokud je řeč odmítnuta nebo selže, textová odpověď zůstane. Hlas se nastavuje v Elowen; plugin WhatsApp nemá vlastní nastavení poskytovatele hlasu.
Pro zpracování obrázků nastavte Model pro obrázky na model s podporou zraku, nebo pole nechte prázdné a použije se model chatu. Každá příchozí zpráva nese nejvýše jeden obrázek. Max. velikost příchozího obrázku omezuje velikost jeho stažení a ve výchozím nastavení je 5 MiB; větší obrázky se změní na poznámku o příloze. Max. obrázků na odpověď omezuje sdílené obrázky v odchozí odpovědi, ve výchozím nastavení je 4, nastavit lze 1 až 10.