banghasan/framebot

Telegram bot framework written in PHP.

Framebot

Telegram bot framework menggunakan bahasa pemrograman PHP, merupakan fork dari PHPTelebot yang sudah disesuaikan untuk kebutuhan proyek internal., _(*1)

Tujuan

Sebagai bahan ebook III Bot Telegram - Versi Final!, _(*2)

Fitur

• Simple, mudah digunakan.
• Support Long Polling dan Webhook.

Tambahan

• Support inisiasi dipergunakan untuk session
• Support finalisasi untuk akhir aktifitas (penyimpanan session, dll)

Kebutuhan

• cURL
• PHP 5.4+
• Telegram Bot API Token - diperoleh dari @BotFather.

Installasi

Menggunakan Composer

Install Framebot dengan Composer, tambahkan file composer.json seperti berikut :, _(*3)

{
    "require": {
        "banghasan/framebot": "*"
    }
}

atau jalankan perintah berikut lewat CLI:, _(*4)

composer require banghasan/framebot

Composer akan menginstall autoloader di ./vendor/autoloader.php. Untuk di-include ke codinganmu, tambahkan:, _(*5)

require_once 'vendor/autoload.php';

Install dari Sumber Code

Download Framebot ini dari Github, kemudian include FrameBot.php in your script:, _(*6)

require_once '/path/to/framebot/src/FrameBot.php';

Usage

Creating a simple bot

<?php

require_once './src/FrameBot.php';
$bot = new FrameBot('TOKEN', 'BOT_USERNAME'); // Bot username is optional, its required for handle command that contain username (/command@username) like on a group.

// Simple command
$bot->cmd('*', 'Hi, human! I am a bot.');

// Simple echo command
$bot->cmd('/echo|/say', function ($text) {
    if ($text == '') {
        $text = 'Command usage: /echo [text] or /say [text]';
    }
    return Bot::sendMessage($text);
});

// Simple whoami command
$bot->cmd('/whoami|!whoami', function () {
    // Get message properties
    $message = Bot::message();
    $name = $message['from']['first_name'];
    $userId = $message['from']['id'];
    $text = 'You are <b>'.$name.'</b> and your ID is <code>'.$userId.'</code>';
    $options = [
        'parse_mode' => 'html',
        'reply' => true
    ];

    return Bot::sendMessage($text, $options);
});

$bot->run();

Then run, _(*7)

php file.php

You can also see my other sample., _(*8)

NOTE: - If function parameters is more than one, FrameBot will split text by space. - If you don't set chat_id on options bot will send message to current chat. - If you add option reply => true, bot will reply current message (Only work if you don't set custom chat_id and reply_to_mesage_id)., _(*9)

Commands

Use $bot->cmd(<command>, <function>) to handle command., _(*10)

// simple answer
$bot->cmd('*', 'I am a bot');

// catch multiple commands
$bot->cmd('/start|/help', function () {
   // Do something here.
});

// call a function name
function googleSearch($search) {
   // Do something here.
}
$bot->cmd('/google', 'googleSearch');

Use * to catch any command., _(*11)

File upload

This code will send a photo to users when type command /upload., _(*12)

// Simple photo upload
$bot->cmd('/upload', function () {
    $file = '/path/to/photo.png'; // File path, file id, or url.
    return Bot::sendPhoto($file);
});

Events

Use $bot->on(<event>, <function>) to handle all possible FrameBot events., _(*13)

To handle inline message, just add:, _(*14)

$bot->on('inline', function($text) {
    $results[] = [
        'type' => 'article',
        'id' => 'unique_id1',
        'title' => $text,
        'message_text' => 'Lorem ipsum dolor sit amet',
    ];
    $options = [
        'cache_time' => 3600,
    ];

    return Bot::answerInlineQuery($results, $options);
});

Also, you can catch multiple events:, _(*15)

$bot->on('sticker|photo|document', function() {
  // Do something here.
 });

Supported events:

• * - any type of message
• text – text message
• audio – audio file
• voice – voice message
• document – document file (any kind)
• photo – photo
• sticker – sticker
• video – video file
• contact – contact data
• location – location data
• venue – venue data
• edited – edited message
• pinned_message – message was pinned
• new_chat_member – new member was added
• left_chat_member – member was removed
• new_chat_title – new chat title
• new_chat_photo – new chat photo
• delete_chat_photo – chat photo was deleted
• group_chat_created – group has been created
• channel_chat_created – channel has been created
• supergroup_chat_created – supergroup has been created
• migrate_to_chat_id – group has been migrated to a supergroup
• migrate_from_chat_id – supergroup has been migrated from a group
• inline - inline message
• callback - callback message
• game - game
• channel - channel
• edited_channel - edited channel post

Command with custom regex (advanced)

Create a command: /regex string number, _(*16)

$bot->regex('/^\/regex (.*) ([0-9])$/i', function($matches) {
    // Do something here.
});

Methods

FrameBot Methods

cmd(<command>, <answer>)

Handle a command., _(*17)

on(<event>, <answer>)

Handles events., _(*18)

regex(<regex>, <answer>)

Create custom regex for command., _(*19)

Bot::type()

Return message event type., _(*20)

Bot::message()

Get message properties., _(*21)

Telegram Methods

FrameBot use standard Telegram Bot API method names., _(*22)

Bot::getMe() ?

A simple method for testing your bot's auth token., _(*23)

Bot::sendMessage(<text>, <options>) ?

Use this method to send text messages., _(*24)

Bot::forwardMessage(<options>) ?

Use this method to forward messages of any kind., _(*25)

Bot::sendPhoto(<file path | file id | url>, <options>) ?

Use this method to send a photo., _(*26)

Bot::sendVideo(<file path | file id | url>, <options>) ?

Use this method to send a video., _(*27)

Bot::sendAudio(<file path | file id | url>, <options>) ?

Use this method to send a audio., _(*28)

Bot::sendVoice(<file path | file id | url>, <options>) ?

Use this method to send a voice message., _(*29)

Bot::sendDocument(<file path | file id | url>, <options>) ?

Use this method to send a document., _(*30)

Bot::sendSticker(<file path | file id | url>, <options>) ?

Use this method to send a sticker., _(*31)

Bot::sendLocation(<options>) ?

Use this method to send point on the map., _(*32)

Bot::sendVenue(<options>) ?

Use this method to send information about a venue., _(*33)

Bot::sendContact(<options>) ?

Use this method to send phone contacts., _(*34)

Bot::sendAction(<action>, <options>) ?

Use this method when you need to tell the user that something is happening on the bot's side., _(*35)

Bot::getUserProfilePhotos(<user id>, <options>) ?

Use this method to get a list of profile pictures for a user., _(*36)

Bot::getFile(<file id>) ?

Use this method to get basic info about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size., _(*37)

Bot::answerInlineQuery(<array of results>, <options>) ?

Use this method to send answers to an inline query., _(*38)

Bot::answerCallbackQuery(<text>, <options>) ?

Use this method to send answers to callback queries sent from inline keyboards., _(*39)

Bot::getChat(<chat_id>) ?

Use this method to get up to date information about the chat., _(*40)

Bot::leaveChat(<chat_id>) ?

Use this method for your bot to leave a group, supergroup or channel., _(*41)

Bot::getChatAdministrators(<chat_id>) ?

Use this method to get a list of administrators in a chat., _(*42)

Bot::getChatMembersCount(<chat_id>) ?

Use this method to get the number of members in a chat., _(*43)

Bot::getChatMember(<options>) ?

Use this method to get information about a member of a chat., _(*44)

Bot::kickChatMember(<options>) ?

Use this method to kick a user from a group or a supergroup., _(*45)

Bot::unbanChatMember(<options>) ?

Use this method to unban a previously kicked user in a supergroup., _(*46)

Bot::editMessageText(<options>) ?

Use this method to edit text messages sent by the bot or via the bot (for inline bots)., _(*47)

Bot::editMessageCaption(<options>) ?

Use this method to edit captions of messages sent by the bot or via the bot (for inline bots)., _(*48)

Bot::editMessageReplyMarkup(<options>) ?

Use this method to edit only the reply markup of messages sent by the bot or via the bot (for inline bots)., _(*49)

Bot::sendGame(<game short name>, <options>) ?

Use this method to send a game., _(*50)

Bot::setGameScore(<options>) ?

Use this method to set the score of the specified user in a game., _(*51)

Bot::getGameHighScores(<user id>, <options>) ?

Use this method to get data for high score tables., _(*52)

Webhook installation

Open via browser https://api.telegram.org/bot<BOT TOKEN>/setWebhook?url=https://yourdomain.com/your_bot.php, _(*53)