directus-extension-telegram-message-operation

📩 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.

🚀 Features

  • 📡 Send messages to Telegram users or groups
  • 🔧 Flow-friendly configuration (Bot Token, Chat ID, Message)
  • 🧩 Fully compatible with Directus Flows
  • 👨‍💻 No coding knowledge required

🧠 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.

🛠️ 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

🔐 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

👥 How to Find Chat ID or Group ID

🔸 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...}

🔸 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

⚙️ 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:
    • 🔐 Bot Token
    • 🆔 Chat ID
    • 💬 Message

📤 Output

Success:

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

Error:

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

🧩 Extension Details

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

📁 File structure:

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

🤝 Need Help?

Contact @cryptoraichu on:

Built with ❤️ by UNCW3B Software