Telegram Channel
@omadia/channel-telegram
Telegram als zweiter First-Class-Channel von Omadia. Speaks die Telegram Bot API direkt (kein Drittanbieter-SDK), supports Webhook + Long-Polling-Fallback, MarkdownV2-Rendering, Inline-Keyboards für Choice-Cards / Slot-Picker / Follow-Ups, Roster via getChatAdministrators für Gruppen. Self-contained — keine `depends_on`-Beziehung. Validiert die @omadia/channel-sdk Contracts gegen ein Runtime ohne Bot-Framework.
- latest
- v0.1.4
- license
- MIT
- versions
- 4
- author
- byte5 GmbH
install
In your omadia instance, open Admin → Registries and add this registry, then install Telegram Channel from Admin → Plugins → Store.
https://hub.omadia.aisetup guide
Create a Telegram bot
Telegram bots are issued by @BotFather — no developer account needed. Takes about 2 minutes.
1. Create the bot
- In Telegram, open the chat with @BotFather.
- Send
/newbot→ pick a display name → a unique username ending inbot. - BotFather replies with the HTTP API token (
123456:ABC-…). You paste this as the bot token secret during install. - Optional:
/setprivacy→ Disable so the bot can read all group messages (otherwise only commands and @mentions).
2. Public URL vs. long-polling
- Public HTTPS host: set Public HTTPS Base-URL to your origin
(e.g.
https://bot.example.com). Telegram delivers updates to<base>/api/telegram/webhook. - No public host (local dev): leave it empty → the bot uses long-polling (getUpdates), no tunnel needed.
3. DM policy
DM-Auth-Policy controls who may DM the bot: pairing (default — users
pair via a QR deep-link first), open (anyone with the username), or
disabled. Group access is handled separately when a paired operator adds
the bot to a group.
versions
setup fields
Values the operator fills in at install-time.
permissions
memory
reads: [0] · writes: [0]
graph
reads: [0] · writes: [0]
network
outbound: [1]
filesystem
scratch: false