Обработка slash команд

Описание параметров

В telegram slash команды являются кликабельными, что позволяет быстро выполнять определенные действия. Например вывести список пользователей или получить пользователя с идентификатор 1.

Для того чтобы работать со slash командами нужно использовать атрибут SlashHandlerAttribute.

/// <summary>
/// Конструктор.
/// </summary>
/// <param name="botIds">Идентификаторы ботов.</param>
/// <param name="commandComparison">Как сравнивать команду.</param>
/// <param name="stringComparison">Как сравнивать строку.</param>
/// <param name="splitChar">Символ разделителя.</param>
/// <param name="commands">Команды.</param>
public SlashHandlerAttribute(long[] botIds, CommandComparison commandComparison, StringComparison stringComparison, char splitChar, params string[] commands)
public SlashHandlerAttribute(char splitChar, params string[] commands)
public SlashHandlerAttribute(params string[] commands)
public SlashHandlerAttribute(long botId, params string[] commands)
public SlashHandlerAttribute(long botId, char splitChar, params string[] commands)
public SlashHandlerAttribute(long[] botIds, params string[] commands)
public SlashHandlerAttribute(long[] botIds, char splitChar, params string[] commands)
public SlashHandlerAttribute(CommandComparison commandComparison, params string[] commands)
public SlashHandlerAttribute(CommandComparison commandComparison, char splitChar, params string[] commands)
public SlashHandlerAttribute(long botId, CommandComparison commandComparison, params string[] commands)
public SlashHandlerAttribute(long botId, CommandComparison commandComparison, char splitChar, params string[] commands)
public SlashHandlerAttribute(long[] botIds, CommandComparison commandComparison, params string[] commands)
public SlashHandlerAttribute(long[] botIds, CommandComparison commandComparison, char splitChar, params string[] commands)
public SlashHandlerAttribute(StringComparison stringComparison, params string[] commands)
public SlashHandlerAttribute(StringComparison stringComparison, char splitChar, params string[] commands)
public SlashHandlerAttribute(long botId, StringComparison stringComparison, params string[] commands)
public SlashHandlerAttribute(long botId, StringComparison stringComparison, char splitChar, params string[] commands)
public SlashHandlerAttribute(long[] botIds, StringComparison stringComparison, params string[] commands)
public SlashHandlerAttribute(long[] botIds, StringComparison stringComparison, char splitChar, params string[] commands)
public SlashHandlerAttribute(CommandComparison commandComparison, StringComparison stringComparison, params string[] commands)
public SlashHandlerAttribute(CommandComparison commandComparison, StringComparison stringComparison, char splitChar, params string[] commands)
public SlashHandlerAttribute(long botId, CommandComparison commandComparison, StringComparison stringComparison, params string[] commands)
public SlashHandlerAttribute(long botId, CommandComparison commandComparison, StringComparison stringComparison, char splitChar, params string[] commands)

Получение значения после нижнего подчеркивания

using PRTelegramBot.Attributes;
using PRTelegramBot.Extensions;
using PRTelegramBot.Interfaces;
using PRTelegramBot.Models.Enums;
using Helpers = PRTelegramBot.Helpers;

namespace ConsoleExample.Examples.Commands
{
    internal class ExampleSlashCommands
    {
        /// <summary>
        /// Команда отработает для бота с botId 0.
        /// Команда отработает при написание в чат "/example".
        /// </summary>
        [SlashHandler("/example")]
        public static async Task ExampleSlashCommand(IBotContext context)
        {
            string msg = $"Команда /example";
            msg += "\n /get_1 - команда 1" +
                "\n /get_2 - команда 2" +
                "\n /get_3 - команда 3" +
                "\n /get_4 - команда 4";
            await Helpers.Message.Send(context, msg);
        }

        /// <summary>
        /// Команда отработает для бота с botId 0.
        /// Команда отработает при написание в чат "/get".
        /// Команда отработает при написание в чат "/get_1", значение 1 можно обработать.
        /// </summary>
        [SlashHandler('_', "/get")]
        public static async Task ExampleSlashCommandGet(IBotContext context)
        {
            var args = context.GetSlashArgs();

            // Нет аргументов
            if (args.Count == 0)
            {
                await Helpers.Message.Send(context, "Команда /get");
                return;
            }

            // Один аргумент
            if (args.Count == 1)
            {
                await Helpers.Message.Send(context, $"Команда /get со значением: {args[0]}");
                return;
            }

            // Несколько аргументов
            string joinedArgs = string.Join(", ", args);
            await Helpers.Message.Send(context, $"Команда /get со значениями: {joinedArgs}");
        }

        /// <summary>
        /// Команда отработает для бота с botId 0.
        /// Команда отработает при написание в чат "/int".
        /// Команда отработает при написание в чат "/int_1", значение 1 можно обработать.
        /// </summary>
        [SlashHandler('_', "/int")]
        public static async Task ExampleSlashIntCommandGet(IBotContext context)
        {
            var args = context.GetSlashArgs<int>();

            // Нет аргументов
            if (args.Count == 0)
            {
                await Helpers.Message.Send(context, "Команда /int");
                return;
            }

            // Один аргумент
            if (args.Count == 1)
            {
                await Helpers.Message.Send(context, $"Команда /int со значением: {args[0]}");
                return;
            }

            // Несколько аргументов
            string joinedArgs = string.Join(", ", args);
            await Helpers.Message.Send(context, $"Команда /int со значениями: {joinedArgs}");
        }

        /// <summary>
        /// Команда отработает для бота с botId 0.
        /// Команда отработает при написание в чат "/bool".
        /// Команда отработает при написание в чат "/bool_true", значение 1 можно обработать.
        /// </summary>
        [SlashHandler('_', "/bool")]
        public static async Task ExampleSlashBoolCommandGet(IBotContext context)
        {
            var args = context.GetSlashArgs<bool>();

            // Нет аргументов
            if (args.Count == 0)
            {
                await Helpers.Message.Send(context, "Команда /bool");
                return;
            }

            // Один аргумент
            if (args.Count == 1)
            {
                await Helpers.Message.Send(context, $"Команда /bool со значением: {args[0]}");
                return;
            }

            // Несколько аргументов
            string joinedArgs = string.Join(", ", args);
            await Helpers.Message.Send(context, $"Команда /bool со значениями: {joinedArgs}");
        }

        /// <summary>
        /// Команда отработает для бота с botId 0.
        /// Команда отработает при написание в чат "/start".
        /// Команда отработает при написание в чат "/start 1", значение 1 можно обработать.
        /// </summary>
        [SlashHandler(' ', "/start")]
        public static async Task ExampleSlashCommandStart(IBotContext context)
        {
            var args = context.GetSlashArgs();
            if (args.Count > 0)
            {
                string msgWithArgs = $"Команда /start со значением {args[0]}";
                await Helpers.Message.Send(context, msgWithArgs);
                return;
            }

            string msg = $"Команда /start";
            await Helpers.Message.Send(context, msg);
        }

        /// <summary>
        /// Команда отработает для бота с botId 0.
        /// Команда отработает при написание в чат "/equals", сработает только если текст сообщения будет /equals но при этом регистро не зависимо.
        /// /equals_1 не сработает.
        /// </summary>
        [SlashHandler(CommandComparison.Equals, "/equals")]
        public static async Task ExampleSlashEqualsCommand(IBotContext context)
        {
            string msg = nameof(ExampleSlashEqualsCommand);
            await Helpers.Message.Send(context, msg);
        }

        /// <summary>
        /// Команда отработает для бота с botId 0.
        /// Команда отработает при написание в чат "/equalsreg", сработает только если текст сообщения будет /equalsreg но при этом регистро зависимо.
        /// Не сработает/equals_1, /equalsreG, /Equalsreg.
        /// </summary>
        [SlashHandler(CommandComparison.Equals, StringComparison.Ordinal, "/equalsreg")]
        public static async Task ExampleSlashEqualsRegisterCommand(IBotContext context)
        {
            string msg = nameof(ExampleSlashEqualsRegisterCommand);
            await Helpers.Message.Send(context, msg);
        }
    }
}

Пример работы

Slash команды можно объединять с обычными командами

public class Commands
{
    /// <summary>
    /// Напишите в чате "Тест"
    /// </summary>
    [ReplyMenuHandler("Тест")]
    [SlashHandler("/test")]
    public static async Task ExampleReply(IBotContext context)
    {
        string msg = "Бот: ответ бота тест";
        await PRTelegramBot.Helpers.Message.Send(context, msg);
    }
}