Documentation
AcademyCommunitySign In
  • 👋Overview
  • 💙Platform Features
  • Getting started
    • 🚪Signing up & Logging in
      • 👤Profile Settings
    • 🎛️App Management
    • ✴️Templates to Start With
      • Basic Template (Blank app)
      • CRM Template
    • 👨‍🎓Learning Directual
      • 👨‍🏫Webinars
  • Data base
    • Data Structures
      • System Structures
    • Data Types
      • Markdown Cheat Sheet
      • Indexing Fields
      • Formatting Date/Time
    • Directual Query Language (DQL)
    • Import and Export
      • Import API
    • File Storage
      • API for File Storage
  • API and integraions
    • API-Endpoints
      • Advanced techniques for GET and POST requesting
        • Paging for GET-requests
        • Dynamic sorting for GET-requests
        • Custom filtering parameters for GET-requests
        • Advanced filtering for GET-requests
        • Formatting response for GET-request
        • Fields validation for POST-requests
        • Synchronic scenarios for POST-requests
        • Cross-Origin Resource Sharing CORS
      • API testing and debugging
      • Coding mode (raw mode) in filters
      • Swagger specification
    • Webhooks
    • Authentication API
      • Login/password
      • OpenID connect
      • Facebook oAuth
      • Google oAuth
    • Security Features
    • Other Integrations
      • OpenAI
      • Integration Hubs
        • Zapier
      • Telegram
        • Telegram: Advanced Techniques
      • Email
        • SMTP
        • Gmail
      • Twilio SMS
      • Airtable
      • Coupler.io
      • Other No-Code Tools
        • Bubble.io
          • Authorization
          • Displaying Data from Directual on Bubble
        • Adalo
        • UI bakery
        • Tilda
        • AppGyver
  • App interface
    • Web-App Builder basics
    • Web-App Settings
      • General web-app settings
      • Main menu
      • Creating a logotype
      • Web-App color scheme
      • Web-app typography
      • White Labeling
      • Web-App Icon
      • Custom Domain
      • Custom code
    • Setting Up Page Layout
      • Subpages and URL Parameters
    • Components
      • Multistep Form
      • Cards
      • Table
      • Kanban
      • Chart
      • Markdown text
      • HTML code
      • Hint
      • Link Button
      • Video
      • Form (outdated)
    • Embedding Pages
  • Scenarios
    • Understanding Directual Scenarios
      • Directual Event Model
    • Event-Based Triggers
    • Scheduled Triggers
      • Cron Format
    • Synchronous Scenarios
    • Editing Scenarios
      • System Steps
        • Start step
        • Delay step
        • Comment step
        • Catch error step
        • Link scenario step
        • Exit step
      • Action steps
        • Edit object step
        • Create object step
        • Search objects step
        • JSON step
        • Delete object step
        • Run report step
        • Generate document step
        • JS SDK step
      • Condition steps
        • Condition step
        • A/B test step
        • JS SDK condition step
      • Integration steps
        • HTTP-request step
        • Zapier step
        • Telegram step
        • API response
        • Email step
        • SQL-request step
        • Queue step
    • Using Variables
      • Global Variables
      • Context Variables (scenario parameters)
    • Testing and Debugging
    • System Scenarios
    • Advanced Scenario Settings
  • Template system
    • Templating Principles
      • Templating Techniques for Scenarios
      • Templating Techniques for Web-pages
    • Coding Mode (evaluating as a JS-expression)
    • Comparison Component
      • Regular Expressions
    • Tips for Dealing with Data
  • Telegram
    • Telegram
  • Plugins
    • 🔌Using Plugins
      • Scenario Steps Plugins
      • Web Plugins
      • User Authentication Plugins (Not Web3)
        • TMA (Telegram Mini App)
        • Google OAuth Plugin
        • Facebook OAuth Plugin
        • Open ID Auth Plugin
      • Blockchain (Web3)
        • TON (The Open Network)
        • Polygon
        • Ethereum
        • NEAR Protocol
        • NFT and Smart-Contracts
        • MetaMask Wallet
        • WalletConnect
      • WebSockets (Socket.IO)
    • 🪚Developing Plugins
      • Developing Scenario Plugins
      • Developing Web-plugins
        • Example: Using Chart.js in Directual
        • Example: Building Simple Form
        • Example: TON plugin
  • Teams
    • Teams
    • Sandbox Apps
  • JavaScript SDK
    • Directual + JavaScript SDK: The Basics
    • Internal $D Methods
    • Using Google Sheets
    • JS SDK: Examples
  • Reports
    • Reports
  • App life cycle management
    • App Versions
  • Directual 💙 React JS
    • Directual + React JS
  • Pricing and billing
    • 💳How Billing Works
    • 🎁Promo Codes
    • Pricing Plans for Apps
    • Team Pricing Plans
    • How we count requests and operations
    • On-Demand Resource Consumption
    • 🤝Affiliate Program
  • Hire a Directual expert
    • 🏆Certification
    • 🤝Matching with Experts
    • 🏦Escrow service
  • Security and stability
    • 🛡️Public Cloud
    • Platform Architecture
  • Support
    • 📬Contact Directual
  • Directual step-by-step
    • Public Development Roadmap
      • Step 0: Planning App Architecture
      • Step 1: Requesting Features
      • Step 2: Approving Features
      • Step 3. Upvoting Features
      • Step 4. Watching Features
    • Weather Forecast App
    • Web3 Marketplace on Polygon
    • Transferring NFT
Powered by GitBook
On this page
  • What is Telegram
  • Directual–Telegram basics
  • Step 1. Create a bot
  • Step 2. Connect your bot to the app
  • Step 3. Find Telegram structures in Directual
  • Step 4. Test the integration and investigate TMessageIn structure
  • Step 5. Creating a simple scenario

Was this helpful?

  1. API and integraions
  2. Other Integrations

Telegram

The best messenger

PreviousZapierNextTelegram: Advanced Techniques

Last updated 11 months ago

Was this helpful?

What is Telegram

is a messenger that allows for the creation of advanced chatbots. Let's explore how you can create a Telegram bot using Directual.

Directual–Telegram basics

Step 1. Create a bot

Open the messenger and go to the and type /newbot

The BotFather will give you an HPPT API secret token (the red one).

Step 2. Connect your bot to the app

Go to Directual app, Plugins section → Telegram , insert the secret token you copied and click Install.

Step 3. Find Telegram structures in Directual

Go to Database section, Integrations/Telegram folder (it appears automatically). Here you will find five data structures:

  • Incoming Telegram messages (system name TMessageIn). Stores all messages that users have sent to the bot.

  • Outcoming Telegram messages (system name TMessageOut). Stores all messages that the bot have sent to users.

  • Users Telegram (system name TUser). Stores Users who have sent messages to the bot.

  • Chats Telegram (system name TChat). Stores Chat-objects. That is the object which is used by scenario Telegram step as a 'destination'.

  • Keyboards Telegram (Legacy) (system name TKeyboard).

Step 4. Test the integration and investigate TMessageIn structure

Type something to the bot! Send a picture, a file, or location details. Then check the TMessageIn structure.

Let's have a look at new objects which appeared in TMessageIn!

The clue field for text messages is text — it contains the message. Also there is information referring to images, files and locations.

Information about files and images are stored as Telegram file IDs, further in this manual we'll figure out how to download and process them.

Step 5. Creating a simple scenario

The bot will behave as follows:

Also, a for receiving Telegram messages has been added, and a new Parse incoming telegram messages has appeared (do not edit them!).

Create a new scenario, which triggers new objects in TMessageIn structure. (See ):

Put the in scenario and configure it as follows (don't forget to publish and run the scenario):

Check out some

webhook
System scenario
scenarios documentation
Telegram step
useful techniques for building Telegram bots with Directual
Telegram
BotFather
Secret token is red. Here on the screenshot it is masked partially :)
Different messages are being sent to the bot