televerse 1.2.0

Televerse is a Telegram Bot API Framework written completely in Dart. You can use this framework to create your own Telegram Bots, efficiently and easily.

example/televerse_example.dart

import 'dart:io';

import 'package:televerse/televerse.dart';

void main() {
  final String token = Platform.environment["BOT_TOKEN"]!;

  Bot bot = Bot(token);

  // Note: You can use the [onMessage] getter to listen to all messages
  //     or use the [onCommand] getter to listen to commands
  bot.onMessage.listen((MessageContext ctx) async {
    // Collect the ChatID from the context
    // This one is actually from v1.0.0, starting from v1.1.0 you can use the [ctx.id] getter
    final chatId = ChatID(ctx.chat.id);

    // Send a message to the chat
    await ctx.reply("Hello World!");

    // And with the [api] getter you can access the Telegram API
    await ctx.api.sendMessage(chatId, "Hello World!");

    // Looking for a way to send a photo?
    // You can use the [sendPhoto] method
    final photo = InputFile.fromUrl("https://i.imgur.com/1Z1Z1Z1.jpg");
    await ctx.api.sendPhoto(ctx.id, photo);
  });

  // Listen to commands
  bot.command("start", (ctx) => ctx.reply("Hello!"));
  bot.command("bye", (ctx) => ctx.reply("Bye!"));

  // Add advanced filters to particularly listen to messages
  bot.filter((ctx) => false, (ctx) {
    ctx.reply("This message will never be sent");
  });

  // Or you can do this:
  bool myAdvancedFilter(MessageContext ctx) {
    return (ctx.message.photo?.last.fileSize ?? 0) > 1000000;
  }

  bot.filter(myAdvancedFilter, (ctx) {
    // This will only be executed if the filter returns true
    // That is if the photo is bigger than 1MB
    ctx.reply("Oh wow, this is a big photo!");
  });

  // The [bot.hears] method allows you to listen to messages that match a regular expression.
  // You can use the `MessageContext.matches` getter to access the matches of the regular expression.
  bot.hears(RegExp(r'Hello, (.*)!'), (ctx) {
    ctx.reply('Hello, ${ctx.matches![1]}!');
  });

  // With the [Bot.on] method you can listen for particular updates and you can
  // execute a callback function with the [Context] object as parameter.
  bot.on(TeleverseEvent.text, (ctx) {
    // ctx will be of type [MessageContext]
    ctx as MessageContext;
    ctx.reply("This will only be executed if the message has text");
  });

  bot.start();
}