telegram

Adds cards to Boards for connecting with Telegram.

AUTHOR.md

protofy

we're inventors empowering inventors

TAGS.txt

CHAT

SOCIAL

README.md

๐Ÿค– Telegram (Bot-First)

Bring Telegram bots into your workflow. This asset adds bot-connected cards to your Boards so conversations and automations live in one place โ€” and includes a ready-to-use board that serves files on demand.

๐Ÿง  What is this?

A lightweight bridge between your Telegram bot and Boards: send messages/media, receive incoming texts, and control who can talk to your bot.

๐Ÿงฉ Cards added

  • - Telegram connector โ€“ set TELEGRAM_BOT_TOKEN and TELEGRAM_BOT_USERNAME
  • - Last received message โ€“ shows the latest text your bot received
  • - Send message โ€“ post text to a chat ID
  • - Send photo โ€“ send an image (URL or local path)
  • - Send file โ€“ send any document
  • - Allowed chats โ€“ whitelist chat IDs the bot will accept

๐Ÿ“ฆ Included example board: Telegram โ†” Files Bot

A minimal board that listens for /files <filename> and sends the requested file from data/public.

How it works

  • - On every incoming message, it refreshes the file list from data/public.
  • - If a message starts with /files <filename>:
    • - Checks if <filename> exists in data/public.
    • - If yes โ†’ sends the file.
    • - If no โ†’ replies with "File does not exist."

Usage


/files <filename>

Example: /files vento-logo.png

Notes: exact filename match (case-sensitive). Folder scanned: data/public.

โš™๏ธ Setup (1-min)

  1. - Create a bot with @BotFather โ†’ get the token and username
  2. - Open the Telegram connector card โ†’ paste both keys
  3. - (Optional) Add chat IDs in Allowed chats
  4. - (Optional) Place files in data/public to use the example board

Your bot is now connected to your Boards.