AnanovoandGitHub
76e00f0091
* feat(hub): add background-only ServerChan fallback * fix(hub): validate ServerChan background setting type * fix(web): preserve pending visibility transitions * fix(web): guard visibility reports across subscriptions
2.4 KiB
Notifications
Get notified when sessions need input, request permissions, fail, or complete — via Telegram, Server酱 (ServerChan), Web Push, or voice.
Web Push works out of the box once you install the PWA; no configuration needed. The channels below are optional.
Telegram Setup
Enable Telegram notifications and Mini App access:
- Message @BotFather and create a bot
- Set the bot token and public URL
- Start the hub and bind your account
export TELEGRAM_BOT_TOKEN="your-bot-token"
export HAPI_PUBLIC_URL="https://your-public-url"
hapi hub
Then message your bot with /start, open the app, and enter your CLI_API_TOKEN.
Related environment variables:
TELEGRAM_NOTIFICATION- Enable/disable Telegram notifications (default:true)
Troubleshooting:
- If binding fails, verify
HAPI_PUBLIC_URLis accessible from the internet - Telegram Mini App requires HTTPS (not HTTP)
ServerChan (Server酱) Setup
Server酱 pushes notifications to WeChat and other channels. The hub sends ServerChan messages when a session is ready for input, requests a permission, a task fails, or a session completes.
- Get a SendKey from sct.ftqq.com
- Set the SendKey and start the hub:
export SERVERCHAN_SENDKEY="your-sendkey"
export HAPI_PUBLIC_URL="https://your-public-url"
hapi hub
Messages include a link back to the session, built from HAPI_PUBLIC_URL.
Related environment variables:
SERVERCHAN_NOTIFICATION- Enable/disable ServerChan notifications (default:true)SERVERCHAN_BACKGROUND_ONLY- Only send ServerChan notifications when the namespace has no visible HAPI connection (default:false)
When SERVERCHAN_BACKGROUND_ONLY=true, a visible HAPI connection suppresses ServerChan for the entire namespace. Hidden, disconnected, or closed HAPI pages do not count as visible, so ServerChan can act as a background fallback. This is namespace-wide and does not select a particular device.
These values can also be set in settings.json (serverChanSendKey, serverChanNotification, serverChanBackgroundOnly).
Voice assistant setup
Enable voice control:
- Get an API key from elevenlabs.io
- Set the environment variable:
export ELEVENLABS_API_KEY="your-api-key"
hapi hub --relay
See Voice Assistant for usage details.