Telegram Integration

This page describes how to connect a SipPulse AI Agent to a Telegram bot using a bot token from BotFather.

1. What is Telegram Integration?

Telegram Integration is a deployment channel that allows you to connect your agent to a Telegram bot. Users can interact with your agent directly through Telegram by sending messages to the bot.

How to Create a Telegram Bot

Before connecting, you need a Telegram bot. Open Telegram, search for @BotFather, and send the /newbot command. Follow the instructions to create your bot and obtain the bot token.

When to Use Telegram

Ideal scenarios:

• Customer support and FAQ automation
• Notifications and alerts delivered via Telegram
• Interactive services accessible from any Telegram client (mobile, desktop, web)
• Quick deployment with no infrastructure requirements

2. Initial Setup

Prerequisites

• A Telegram bot created via @BotFather
• The bot token provided by BotFather
• The bot cannot be connected to another agent

Connect a Bot

1. Navigate to Agents and select the desired agent.
2. Open the Deploy tab and locate the Telegram card.
3. Click Connect.
4. In the modal, paste your bot token (obtained from BotFather).
5. Click Connect to confirm.
6. Once connected, the card will display your bot's @username (linked to Telegram) and the status will change to Online.

One bot per agent

Each Telegram bot can only be connected to one agent at a time. If you try to connect a bot that's already in use, you'll see an error message.

Test Before Deploying

You can test your agent in the Playground before deploying it to Telegram. This helps ensure the conversational flow works as expected.

3. How It Works in Practice

Message Flow

User sends message → Telegram → SipPulse AI → Agent processes → Response sent to Telegram

When the integration is active, every message sent to your bot is forwarded to the agent for processing. The agent analyzes the message and generates an appropriate response based on its configuration.

The /start Command

When a user starts a conversation with your bot (by sending /start), the bot can send a customizable welcome message. This is configured in the bot's preferences (see Configuration).

4. Management

Enable or Disable Quickly

Use the toggle switch on the card to control the integration:

• On — The agent processes incoming messages in real time.
• Off — Incoming messages are ignored; no token charges apply.

Status

The card displays the current status:

Status	Description
Online	Bot is active and processing messages.
Offline	Bot is disabled or not connected.

Options Menu

Click the options menu on the Telegram card to access:

• Preferences — Configure the start message (see Configuration).
• Remove — Disconnect and remove the bot integration entirely.

5. Configuration

Start Message

The start message is sent automatically when a user sends /start to your bot. This is typically the first interaction a user has with your bot.

To configure:

1. Click the options menu on the Telegram card.
2. Select Preferences.
3. Enable the Start Message toggle.
4. Write your welcome message in the text area.
5. Click Save.

TIP

Use the start message to introduce your agent, explain what it can do, and guide users on how to interact with it.

6. Troubleshooting

Invalid Bot Token

If you see an error when connecting, verify that:

• The token was copied correctly from BotFather (format: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).
• The bot has not been deleted or revoked in BotFather.

Bot Already in Use

If the bot is already connected to another agent, you need to either:

• Remove the bot from the other agent first, or
• Create a new bot via BotFather.

Bot Not Responding

If the bot is connected but not responding to messages:

• Check that the toggle switch is On (not disabled).
• Verify the agent has proper instructions configured.
• Test the agent in the Playground to ensure it responds correctly.