|
@@ -162,7 +162,7 @@ gateway:
|
|
|
| `CHATTO_LOGIN` | Yes* | — | Chatto username (login) |
|
|
| `CHATTO_LOGIN` | Yes* | — | Chatto username (login) |
|
|
|
| `CHATTO_PASSWORD` | Yes* | — | Chatto password |
|
|
| `CHATTO_PASSWORD` | Yes* | — | Chatto password |
|
|
|
| `CHATTO_TOKEN` | No | — | Existing bearer token — alternative to login/password |
|
|
| `CHATTO_TOKEN` | No | — | Existing bearer token — alternative to login/password |
|
|
|
-| `CHATTO_HOME_CHANNEL` | No | First joined room | Default delivery target for cron/notification output when there is no inbound conversation context to reply into. Not exempt from the mention lists. |
|
|
|
|
|
|
|
+| `CHATTO_HOME_CHANNEL` | No | _(none)_ | Default delivery target for cron/notification output when there is no inbound conversation context to reply into. Without it, context-less deliveries have no Chatto target and are not sent. Not exempt from the mention lists. |
|
|
|
| `CHATTO_ALLOWED_USERS` | No | _(deny all)_ | Comma-separated Chatto logins (or user IDs) allowed to talk to the agent. Exact match, case-sensitive. |
|
|
| `CHATTO_ALLOWED_USERS` | No | _(deny all)_ | Comma-separated Chatto logins (or user IDs) allowed to talk to the agent. Exact match, case-sensitive. |
|
|
|
| `CHATTO_ALLOW_ALL_USERS` | No | `false` | Allow any Chatto user to talk to the agent (`true`/`false`) |
|
|
| `CHATTO_ALLOW_ALL_USERS` | No | `false` | Allow any Chatto user to talk to the agent (`true`/`false`) |
|
|
|
| `CHATTO_REQUIRE_MENTION_ROOMS` | No | _(silent everywhere)_ | Comma-separated room IDs where Hermes answers only when addressed (`@name`, `@all`, `@here`). A room on neither mention list stays silent. |
|
|
| `CHATTO_REQUIRE_MENTION_ROOMS` | No | _(silent everywhere)_ | Comma-separated room IDs where Hermes answers only when addressed (`@name`, `@all`, `@here`). A room on neither mention list stays silent. |
|
|
@@ -327,7 +327,7 @@ The home channel is the default outbound target for proactive messages — cron
|
|
|
- `CHATTO_HOME_CHANNEL` env var (room ID)
|
|
- `CHATTO_HOME_CHANNEL` env var (room ID)
|
|
|
- `config.yaml` → `gateway.platforms.chatto.extra.home_channel`
|
|
- `config.yaml` → `gateway.platforms.chatto.extra.home_channel`
|
|
|
|
|
|
|
|
-If unset, the first joined room is used as the default home channel. The home channel follows the same participation rules as any room: a silent home channel still receives cron/notification posts, but the bot converses there only if it is listed in one of the mention lists too.
|
|
|
|
|
|
|
+Without a set home channel, context-less cron/notification deliveries have no Chatto target and are not sent — set one if you plan to use Hermes' proactive output. The home channel follows the same participation rules as any room: a silent home channel still receives cron/notification posts, but the bot converses there only if it is listed in one of the mention lists too.
|
|
|
|
|
|
|
|
### Managing Rooms over DM
|
|
### Managing Rooms over DM
|
|
|
|
|
|
|
@@ -438,7 +438,7 @@ grep -i "chatto\|websocket\|realtime" ~/.hermes/logs/gateway.log | tail -30
|
|
|
|
|
|
|
|
- **Self-hosted friendly**: Works with any self-hosted Chatto instance. No cloud account or subscription required.
|
|
- **Self-hosted friendly**: Works with any self-hosted Chatto instance. No cloud account or subscription required.
|
|
|
- **Minimal dependencies**: Only requires `chattolib[realtime]>=0.4.20.post1`, which is vendored — nothing to install.
|
|
- **Minimal dependencies**: Only requires `chattolib[realtime]>=0.4.20.post1`, which is vendored — nothing to install.
|
|
|
-- **Resume cursor support**: On reconnect, the adapter resumes from the last event cursor, so no messages are lost or replayed during transient disconnects.
|
|
|
|
|
|
|
+- **No message backfill**: Events missed while the gateway is down are gone — Chatto keeps no replay for the bot. Redelivered events after a reconnect are recognised and processed only once; anything genuinely new starts from the moment of reconnection.
|
|
|
|
|
|
|
|
## License
|
|
## License
|
|
|
|
|
|