Hello, I built extension for sending message on telegram

:envelope_with_arrow: Directus Telegram Message Sender (Flow Operation)

Send messages to any Telegram user or group using this custom operation inside your Directus Flows.

Developed by UNCW3B Software — your partner in custom dApps, AI SaaS, and web automation solutions.


:rocket: Features

  • :satellite_antenna: Send messages to Telegram users or groups
  • :wrench: Flow-friendly configuration (Bot Token, Chat ID, Message)
  • :puzzle_piece: Fully compatible with Directus Flows
  • :man_technologist: No coding knowledge required

:brain: How It Works

  1. This extension adds a new Flow Operation inside Directus called Send Telegram Message.
  2. In your flow, you configure:
    • Your Telegram Bot Token
    • Target Chat ID or Group ID
    • The Message Content
  3. When the flow is triggered, your message will be sent via Telegram Bot API.

:hammer_and_wrench: Installation

npm install directus-extension-telegram-message-operation

or

npx create-directus-extension
# Or clone this repo into /extensions/directus-extension-telegram-message-operation

Make sure your .env includes:

EXTENSIONS_PATH=./extensions

Then restart Directus:

npx directus start

:locked_with_key: Create Your Telegram Bot

  1. Open Telegram and search for BotFather
  2. Type /newbot and follow the instructions
  3. After naming your bot, you’ll receive a Bot Token like:
123456789:ABC-DEF1234ghIkl-zyx57W2v1u123ew11


:busts_in_silhouette: How to Find Chat ID or Group ID

:small_orange_diamond: Get Personal Chat ID

  1. Start a conversation with your bot
  2. Open this URL in browser:
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
  1. Look for "chat":{"id":12345678...}

:small_orange_diamond: Get Group Chat ID

  1. Add your bot to a group
  2. Send a message in the group
  3. Then again visit:
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates

Group IDs look like: -100xxxxxxxxxx


:gear: Using the Operation in Directus

  1. Go to Flows > Create Flow
  2. Select a trigger (e.g. item created)
  3. Add operation: Send Telegram Message
  4. Fill in:
    • :locked_with_key: Bot Token
    • :id_button: Chat ID
    • :speech_balloon: Message


:outbox_tray: Output

Success:

{
  "status": "success",
  "sent_to": "123456789",
  "message": "Hello from Directus!"
}

Error:

{
  "status": "error",
  "error": "Unauthorized"
}

:puzzle_piece: Extension Details

  • ID: send-telegram-message
  • Type: operation
  • Host: api
  • Dependencies: axios

:file_folder: File structure:

extensions/
    └── directus-extension-telegram-message-operation/
        ├── api.js
        ├── app.js
        └── package.json

:handshake: Need Help?

Contact cryptoraichu on:


Built with :heart: by UNCW3B Software

1 Like

Thanks for sharing your telegram extension @uncw3b-software! :love_letter: