Connectors Telegram

Telegram Integration

Connect your Telegram bot to AI employees. Let your employees receive and respond to Telegram messages, send media, and automate conversations.

Overview

The Telegram integration allows AI employees to:

  • Receive messages - Get incoming messages from Telegram users
  • Send responses - Reply to messages automatically
  • Handle media - Send and receive images, documents, and files
  • Multi-user - Each user can connect their own Telegram bot

Creating a Telegram Bot

Before connecting to GetATeam, you need a Telegram bot:

  1. Open Telegram and search for @BotFather
  2. Send /newbot to start the creation process
  3. Choose a name for your bot (e.g., "My Company Assistant")
  4. Choose a username ending in "bot" (e.g., "mycompany_assistant_bot")
  5. BotFather will give you an API token - save this securely

Keep Your Token Secret

Never share your bot token publicly. Anyone with your token can control your bot. If compromised, regenerate it via BotFather using /revoke.

Connecting to GetATeam

  1. Go to Settings → Connectors
  2. Find the Telegram section
  3. Paste your bot API token
  4. Click Connect
  5. The status should change to "Connected"

Assigning to an Employee

Once connected, assign Telegram to an employee:

  1. Go to the employee's edit page ("More" → "Edit")
  2. Find the Telegram assignment option
  3. Select your connected Telegram bot
  4. Save changes

The employee will now receive and respond to Telegram messages.

Message Flow

When someone messages your Telegram bot:

  1. The message arrives at your GetATeam instance
  2. It's routed to the assigned employee
  3. The employee processes the message
  4. A response is sent back via Telegram

Supported Features

Feature Support
Text messages ✓ Full support
Images ✓ Send and receive
Documents ✓ Send and receive
Voice messages ✓ Receive and transcribe
Videos ✓ Send and receive
Stickers Receive only
Group chats ✓ Supported

Chat Display

Telegram messages appear in the GetATeam chat interface with:

  • A Telegram badge indicating the message source
  • The sender's Telegram username or name
  • Any attached media rendered inline

Access Control

Control who can communicate with your employee via Telegram:

  • Allow everyone - Any Telegram user can message the bot
  • Specific users - Only allowed usernames can interact

Bot Commands

You can set up bot commands via BotFather (/setcommands) to give users an easy way to interact with your employee (e.g., /help, /start).

Best Practices

  • Set a description - Use BotFather to set a clear description of what your bot does
  • Add a profile picture - Make your bot recognizable
  • Configure commands - Set up /start and /help commands
  • Test thoroughly - Send various message types to ensure proper handling

Troubleshooting

Bot not responding

  • Verify the API token is correct
  • Check that the bot is assigned to an employee
  • Ensure the employee has an active session

Messages not appearing

  • Check the Telegram connector status in Settings
  • Verify webhook is properly configured
  • Check server logs for connection errors
PreviousWhatsApp
NextSlack