Haruno Knowledge base

Telegram

Connect a Telegram bot that you create, so Haruno can send messages, photos and files to a chat once you approve each one.

  • Mac appNot availableThe Mac app has no Telegram connector.
  • Windows appAvailable

What it connects

Telegram connects a bot that you create yourself, with one default chat. Find it in Settings ▸ Connectors, under the Messaging button. Messages come from the bot, not from you.

Telegram is the first card under the Messaging button. In the demo it is connected.
The Connectors list narrowed to Messaging, showing the Telegram card connected and the Discord and Slack cards switched off.The Connectors list narrowed to Messaging, showing the Telegram card connected and the Discord and Slack cards switched off.

What Haruno can do

  • Send a text message.
  • Send an image as a photo.
  • Send a file as a document.
  • Say which bot and chat are connected.

Messages people send to the bot can start a hook, if you set one up (advanced view).

How to connect

  1. Make the bot in Telegram
    Open the Telegram bot called BotFather, send /newbot and follow the questions. It answers with a token. Then open your new bot, press Start and send it a message. For a group, add the bot and send /start@ followed by its name.
  2. Turn it on in Haruno
    Open the Telegram card and turn on Enable. Paste the token into Bot token and choose Refresh.
  3. Pick the chat
    The status lists recent chat numbers. Copy yours into Default chat ID, with any minus sign, then choose Connect. No numbers? Send the bot a new message and refresh again.

What needs your approval

Every message, photo and file shows an approval card that names the chat. Choose Allow once or Allow for this session. A remembered approval covers only the same chat.

A scheduled task or a hook has nobody to ask, so these steps are refused and the run says the step needed approval. In the advanced view you can set each action to On, Off or Confirm.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    PR #2944Commit a2a7836The page at this version
    What changed
    @@ -0,0 +1,36 @@
+---
+title: Telegram
+summary: Connect a Telegram bot that you create, so Haruno can send messages, photos and files to a chat once you approve each one.
+feature: connector-telegram
+covers:
+  - Integrations/telegram/**
+---
+
+## What it connects
+
+Telegram connects a bot that you create yourself, with one default chat. Find it in <Ui>Settings ▸ Connectors</Ui>, under the **Messaging** button. Messages come from the bot, not from you.
+
+<Shot src="/m/0d7c0e7d3978-windows-connector-messaging-light.png" dark="/m/d0e8197aa780-windows-connector-messaging-dark.png" alt="The Connectors list narrowed to Messaging, showing the Telegram card connected and the Discord and Slack cards switched off." caption="Telegram is the first card under the Messaging button. In the demo it is connected." />
+
+## What Haruno can do
+
+- Send a text message.
+- Send an image as a photo.
+- Send a file as a document.
+- Say which bot and chat are connected.
+
+Messages people send to the bot can start a hook, if you set one up (advanced view).
+
+## How to connect
+
+<Steps>
+<Step title="Make the bot in Telegram">Open the Telegram bot called BotFather, send `/newbot` and follow the questions. It answers with a token. Then open your new bot, press Start and send it a message. For a group, add the bot and send `/start@` followed by its name.</Step>
+<Step title="Turn it on in Haruno">Open the Telegram card and turn on <Ui>Enable</Ui>. Paste the token into <Ui>Bot token</Ui> and choose <Ui>Refresh</Ui>.</Step>
+<Step title="Pick the chat">The status lists recent chat numbers. Copy yours into <Ui>Default chat ID</Ui>, with any minus sign, then choose <Ui>Connect</Ui>. No numbers? Send the bot a new message and refresh again.</Step>
+</Steps>
+
+## What needs your approval
+
+Every message, photo and file shows an approval card that names the chat. Choose **Allow once** or **Allow for this session**. A remembered approval covers only the same chat.
+
+A scheduled task or a hook has nobody to ask, so these steps are refused and the run says the step needed approval. In the advanced view you can set each action to **On**, **Off** or **Confirm**.