Talking to your assistant on Telegram

Your Victor assistant isn't limited to the web app — you can chat with it from Telegram. It is the same assistant with the same permissions, memory and conversation history: anything it can do for you in the app (answer questions about your records, create or update them, send emails after your approval), it can do from a Telegram chat. You can send it text, photos and voice messages.

Setting it up is one step: an administrator installs the Telegram app from Modules, and each user pairs their own Telegram account.

For administrators: install the app

Open Modules and install Telegram. That's the whole setup — there is no bot to create and no token to paste. Victor runs the bot for you, and every instance uses it.

No firewall changes are needed; Telegram delivers messages to your instance's public address over HTTPS (cloud instances have one out of the box).

Voice messages need a speech-to-text provider

Photos work out of the box. Voice messages are transcribed first, which uses one of your configured AI provider keys — if your instance already has a Google, OpenAI or Groq key set up, voice works automatically (the stt.model parameter defaults to auto, which picks whichever key exists). With no key, the bot politely tells users voice isn't enabled.

For each user: pair your Telegram account

Pairing links your Telegram account to your Victor user, so the assistant knows who it is talking to and acts with your permissions — never anyone else's.

1. Avatar menu (top right) → Personal Settings → Telegram tab.
2. Click Connect Telegram.
3. Click Open @your_bot.

That's it. There's no code to copy — the link opens a chat with your assistant and connects it. The page updates by itself once it's done. The link works once and expires after 10 minutes; press Connect again for a new one.

One Telegram account connects to one Victor user. To move to a different Telegram account, click Unlink and connect again.

Using the chat

• Just type. The chat is one continuous conversation with your assistant — it also appears in your conversation list in the web app, so you can pick it up there later.
• /new starts a fresh conversation; /help shows what the bot can do. Both are in the bot's command menu (the / button).
• Send a photo (optionally with a caption like "what's on this invoice?") — the assistant looks at the image directly.
• Send a voice message — the bot echoes back what it heard (🎤 "…") and then answers.
• Approvals work like in the app: when the assistant wants to change data or send something, it pauses and shows ✅ Approve / ❌ Reject buttons. Nothing runs until you tap Approve.

Same assistant, same memory

There is nothing separate to configure per channel. Preferences the assistant learns about you, your conversation history and your access rights are shared between the web app and Telegram automatically.

Troubleshooting

Symptom	Likely cause
"No Telegram bot is set up yet…"	The Telegram app isn't installed, or the instance hasn't picked up the bot yet — it syncs within a minute of install.
"This Telegram account isn't connected…"	Personal Settings → Telegram → Connect Telegram.
The connect link doesn't work any more	It's single-use and expires after 10 minutes — press Connect again.
The bot never replies after pairing	Your instance may not be reachable from Telegram — see the note below. Contact support.
"Voice messages aren't enabled…"	No speech-to-text provider key is configured — an administrator can add a Google, OpenAI or Groq API key.
"That file is too large…"	Photos and voice notes are limited to 10 MB.

Telegram cannot reach a local development instance

Telegram only delivers to a public https:// address, so the bot will never respond on a plain http://localhost instance. To try the channel locally, expose the instance (just tunnel) and set the web.base_url system parameter to that https URL.