Deployf.Botf 0.1.1

BotF

Make beautiful and clear telegram bots with the asp.net-like architecture!

BotF have next features:

• long pooling and webhook mode without any changes in the code
• very convinient way to work with commands and reply buttons
• integrated pagination with buttons
• authentication and role-based authorization
• statemachine for complicated dialogs with users
• asp.net-like approach to develop bots
• good performance

Documentaion

Visit to our wiki to read botf documentation

Install

dotnet add package Deployf.Botf

Example

Put next code into Program.cs file

using Deployf.Botf;
using Deployf.Botf.Controllers;

class Program : BotfProgram
{
    // It's boilerplate program entrypoint.
    // We just simplified all usual code into static method StartBot.
    // But in this case of starting of the bot, you should add a config section under "bot" key to appsettings.json
    public static void Main(string[] args) => StartBot(args);

    // Action attribute mean that you mark async method `Start`
    // as handler for user's text in message which equal to '/start' string.
    // You can name method as you want
    [Action("/start")]
    public async Task Start()
    {
        // Just sending a reply message to user. Very simple, isn't?
        await Send($"Send `{nameof(Hello)}` to me, please!");
    }

    // If we dont put any parameter into Action attribute,
    // it means that this method will handle messages with hame of the method.
    // Yep, in this case, you should care about the method's name.
    [Action]
    public async Task Hello()
    {
        await Send("Hey! Thank you! That's it.");
    }

    // Here we handle all unknown command or just text sent from user
    [On(Handle.Unknown)] 
    public async Task Unknown()
    {
        // Here, we use the so-called "buffering of sending message"
        // It means you dont need to construct all message in the string and send it once
        // You can use Push to just add the text to result message, or PushL - the same but with new line after the string.
        PushL("You know.. it's very hard to recognize your command!");
        PushL("Please, write a correct text. Or use /start command");
        
        // And finally, send buffered message
        await Send();
    }
}

And replace content of appsettings.json with your bot username and token:

{
  "bot": {
    "Token": "123456778990:YourToken",
    "Username": "username_bot"
  }
}

And that's it! Veeery easy, isn't?
Just run the program 😃

Other examples you can find in /Examples folder.

Hosting

After you develop your bot, you can deploy it to out hosting: deploy-f.com