Telegram free

Telegram is the simplest channel to connect. Create a bot with @BotFather, copy the token, and pass it to connect_telegram(). Caspian registers the webhook and routes every message to the same on_message handler you already have. No other setup, no cost.

1. Create a bot with @BotFather

A bot token is the one thing only a human can make. Open Telegram and message @BotFather:

• Send /newbot.
• Choose a display name and a username (the username must end in bot, e.g. acme_support_bot).
• BotFather replies with a token that looks like 7123456789:AAE-xxxxxxxxxxxxxxxxxxxxxxxxxxx.

That token is the bot's password, so keep it out of source control.

2. Connect it

Pass the token to connect_telegram(). Caspian registers the webhook with Telegram for you, so inbound messages start flowing immediately.

from caspian_sdk import CommClient

client = CommClient()                        # reads COMM_API_KEY / COMM_BASE_URL

tg = client.connect_telegram(bot_token="7123456789:AAE-xxxxxxxx")
print("Telegram bot:", tg["address"])        # @acme_support_bot

@client.on_message
def handle(message):
    # same handler as every other channel
    message.reply(f"You said: {message.text}")

client.listen()                              # blocks, dispatching messages forever

import { CommClient } from "caspian-sdk";

const client = new CommClient();                   // reads COMM_API_KEY / COMM_BASE_URL

const tg = await client.connectTelegram({ botToken: "7123456789:AAE-xxxxxxxx" });
console.log("Telegram bot:", tg.address);          // @acme_support_bot

client.onMessage(async (message) => {
  // same handler as every other channel
  await message.reply(`You said: ${message.text}`);
});

await client.listen();                             // runs forever; pass an AbortSignal to stop

3. Send it a message

With your program running, open Telegram, search for the bot's @username, and send it anything. Your handler fires and the reply lands back in the same chat within a few seconds. That is the whole loop: inbound message to your handler to reply.

Message fields

Telegram messages arrive with the same shape as every other channel:

Reply with message.reply(text); Caspian routes it back to the same Telegram chat automatically.

Troubleshooting

Next steps