televerse 1.4.2

Televerse lets you create your own efficient Telegram bots with ease in Dart. Supports latest Telegram Bot API - 6.5!

example/televerse_example.dart

import 'dart:io';

import 'package:televerse/televerse.dart';

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

  Bot bot = Bot(token, fetcher: LongPolling());

  // 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("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");
  });

  // Since v1.3.1 you can listen for `/start`, `/help` and `/settings` commands
  // in an easier way.
  bot.start((ctx) => ctx.reply("Hello!"));
  bot.settings((ctx) => ctx.reply("Settings"));
  bot.help((ctx) => ctx.reply("Help"));
}