NAME

Telebot::Plugin::Telegram - Telegram API plugin

SYNOPSIS

    # {
    #     message => 'Telebot::Handler::Message',
    #     poll => 'My::Bot::Handler::Poll',
    # }
    my $handlers = $app->tg->handlers();
    
    # 'Telebot::Handler::Message'
    my $message_handler = $app->tg->handler('message');
    
    # 'z8HcRt7Z6wj3E7bwk2pOZx4s'
    my $token = $app->tg->gentoken();

    # 'https://api.telegram.org/botTOKEN/getMe'
    my $url = $app->tg->url('getMe');
    
    # Requests to API
    my $response = $app->tg->request(getMe => {});
    my $response = $app->tg->request(sendMessage => {
        chat_id => 777,
        text => 'Hello, Telegram',
    });
    
    # c('message', 'poll')
    my $allowed_updates = $app->tg->allowed_updates;
    
    # c({
    #     command => 'start',
    #     bot => 'megabot',
    # }, {
    #     command => 'stop',
    #     bot => undef,
    # })
    $app->tg->extract_commands(
        'Please /start@megabot and /stop',
        [{
            type => 'command',
            offset => 7,
            length => 14,
        }, {
            type => 'command',
            offset => 26,
            length => 5,
        }]
    );
    

DESCRIPTION

Telebot::Plugin::Telegram - plugin for working with Telegram API.

HELPERS

Telebot::Plugin::Telegram implements the following helpers.

tg->handlers

Returns hash of registered handlers of update and it's parts. Key - update or name of update field, value - name of handler module.

tg->handler

Returns name of handler module for update or update part.

tg->gentoken

Returns generated token (random string from alphabet symbols and digits)

tg->url

Returns URL for requesting Telegram API method

tg->request

Performs request to Telegram API

tg->allowed_updates

Return Mojo::Collection of allowed updates (set of updates which Telegram sends to bot's webhook).

tg->extract_commands

Extract from text bot commands and return them as Mojo::Collection

tg->config

Returns config of plugin.

METHODS

Telebot::Plugin::Telegram inherits all methods from Mojolicious::Plugin and implements the following new ones.

register

    my $tg = $plugin->register(Mojolicious->new);

Register plugin in Mojolicious application and define helpers.

COPYRIGHT AND LICENSE

Copyright (C) 2022, Igor Lobanov. This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0.

SEE ALSO

https://github.com/igorlobanov/telebot, Mojolicious::Guides, https://mojolicious.org, https://core.telegram.org/bots/api.

cpanm Telebot

perl -MCPAN -e shell
install Telebot