7.1 KiB
7.1 KiB
title, type, status, created, updated, verified_on, confidence, tags, sources
| title | type | status | created | updated | verified_on | confidence | tags | sources | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Messaging Integrations | system | active | 2026-07-22 | 2026-10-11 | 2026-10-11 | high |
|
|
Messaging Integrations
Telegram
- Status: enabled, active
- allowed_chats:
-1004321904721(primary),1793951355(DM), plus the remaining chat IDs required by both multiplexed profiles on the default adapter — verified 2026-09-30 - Rich messages: true
- Platform toolsets: cli, telegram (full suite)
- Delivery targets seen in cron: telegram,
telegram:1793951355,telegram:-1004321904721,telegram:-1004321904721:notifications,telegram:-1004321904721:102,telegram:-1004321904721:273,telegram:-1004321904721:346,telegram:-1004321904721:1030 - Notes: Primary delivery target for scheduled jobs
Delivery target semantics (verified 2026-10-01)
- A bare
deliver: "telegram"resolves to the home DM (1793951355) — not to the primary group. It is not a "send to the main chat" shorthand. - To reach a forum topic you must use the full form
telegram:<chat_id>:<thread_id>, e.g.telegram:-1004321904721:102. - Consequence: a job that names a group topic ID but is actually pointed at the DM fails with
configured thread_id <n> … was not found/Message thread not found. Two variants are observed, and they behave differently (verified 2026-10-02 against~/.hermes/cron/executions.db):Message thread not found— hard failure, the message is lost (the 2026-09-30 incident variant).configured thread_id <n> for telegram:<dm> was not found; delivered without thread_id— a thread-less fallback send does occur, yet the run is still recorded aslast_status: delivery_failed/delivery_outcome: failed. Content reaches the DM; the delivery is marked failed anyway, so the job record reads like a lost message.- Do not assume "delivery failed" means the message never arrived — check the error variant before reporting a report as missing.
Discord
- Status: enabled, streaming true
- Platform:
hermes-discord - Platform toolsets: cli, discord
- Libraries: himalaya CLI available
- Platform toolsets: cli
- Status: ⚠ partially broken — the personal account works, the
workaccount does not.- Personal (Gmail): connected and usable. Google still permits app-password auth.
work(Outlook / Microsoft 365): unreachable.himalaya envelope list -a workfails withError: cannot build IMAP client / Caused by: login not supported. The account is configured for password auth (backend.auth.type = "password"+~/.config/himalaya/get_work_outlook_password.sh) while the tenant advertises onlyXOAuth2— basic auth for IMAP/SMTP is disabled tenant-wide. The TCP/TLS connection tooutlook.office365.com:993succeeds; only the login is refused. This is a policy wall, not a wrong password — re-running the credential helper cannot fix it. See incidents/2026-08-26-work-outlook-basic-auth-disabled.- Fix path: OAuth2 (
backend.auth.type = "oauth2"+ token store) after an app registration with IMAP/SMTP scopes; Anthony's normal Office sign-in is number-matching approval in Microsoft Authenticator, which is the device-code flow this needs. Tenant admin consent may be required. - Consequence for tooling:
email/mail-lookupresolves the account before searching, so a request for work mail will reach this wall and must report the account as unreachable — not as "no results found".
Slack
- Status: available (toolsets: cli, slack-platform)
- Config noted: slack entries in config but Slack enabled status unclear from config grep
Other Platforms Available
- Mattermost: toolsets present (
hermes-mattermost) - Google Chat: toolsets present (
hermes-google_chat) - QQ: toolsets present (
hermes-qqbot) - Signal: toolsets present (
hermes-signal) - WhatsApp: toolsets present (
hermes-whatsapp) - ntfy: noted in memory config outputs but runtime status unverified
- Yuanbao: toolsets present (
hermes-yuanbao) - Home Assistant: homeassistant-platform enabled
Known Issues
- Telegram thread-delivery failures — resolved 2026-09-30. Jobs
fad5a86979d4and1b23c042e17dreportedconfigured thread_id 34795 … was not found, andc8d52904e1d6reportedMessage thread not found(last_status: delivery_failed). Root cause was the target, not the topic: those jobs used a baredeliver: "telegram", which resolves to the home DM where group topic IDs do not exist.1b23c042e17dandc8d52904e1d6were retargeted totelegram:-1004321904721:102and verified end-to-end. See systems/scheduled-tasks. - Three jobs still deliver to the home DM via a bare
telegramtarget (0e753e9720fd,fad5a86979d4,066bb5191280). No longer theoretical — two of them failed delivery on 2026-10-01:066bb5191280(02:11) and0e753e9720fd(09:01) both recordeddelivery_outcome: failedwith the thread-less-fallback variant above, in the same failure class as the 2026-09-30 incident. Retarget them totelegram:-1004321904721:<topic>. See systems/scheduled-tasks.
Multi-bot group chat (open question, raised 2026-09-30)
Anthony asked whether his other Hermes instances (the estate VMs/CTs) could share a group chat.
- Preferred shape: a Telegram supergroup with one forum topic per bot, so each agent posts into its own thread and no two bots share a message stream. Mattermost was floated and rejected.
- Estate reachability: CT460's Hermes serves the WebUI/API on
:9119(locally fronted by nginx on:19119). Whether the other estate hosts expose:9119still needs checking before any fan-out design. - Status: design question only — nothing has been deployed or changed.
Related
2026-10-11 00:20 AWST - Mattermost platform unreachable (observed, not fixed)
The gateway's Mattermost adapter has been down since at least 2026-10-10. gateway.log shows a
5-minute retry cadence with Mattermost: disconnected followed by
Reconnect mattermost error: mattermost connect timed out after 30s, next retry in 300s
(attempt 34 at 00:15, attempt 35 at 00:20).
Probe of the configured endpoint (MATTERMOST_URL=http://100.98.116.14:8065/) from CT460:
100 % ICMP loss and TCP 8065 refuses - the Mattermost host itself is unreachable from CT460,
not merely an application-level refusal.
- Cause not determined; not investigated further during this audit (no host/VM/proxy probe).
- Impact is limited to the messaging path. No cron job depends on Mattermost, and the 2026-10-10 cron fleet ran clean.
- Config: plugin block
plugins...mattermost(enabled: true, home channel5ipo6wfe3j88xxox1gkta3d5mw, nameRhino); the bot token is env-only and is not recorded here.
Open item: re-probe the host; if the host is back but the adapter stays down, restart the gateway's Mattermost platform.