prowebcraft/telebot

Telegram bot with dialogs and session management

Telegram Bot Framework

Telegram bot with dialogs support and session management, _(*1)

PHP Telegram Bot Api

, _(*2)

Based on php wrapper for Telegram Bot API, telebot provides flexible diablogs system (inlines and buttons mode), ability to track responses. Telebot can work in daemon or webhook mode., _(*3)

Bots: An introduction for developers

Bots are special Telegram accounts designed to handle messages automatically. Users can interact with bots by sending them command messages in private or group chats., _(*4)

You control your bots using HTTPS requests to bot API., _(*5)

The Bot API is an HTTP-based interface created for developers keen on building bots for Telegram. To learn how to create and set up a bot, please consult Introduction to Bots and Bot FAQ., _(*6)

Install

Via Composer, _(*7)

``` bash $ composer require prowebcraft/telebot, <sub>(*8)</sub>

## Usage

See example [Telegram Id Bot](https://github.com/prowebcraft/telegram-id-bot). This bot in Telegram - [@identybot](https://t.me/identybot)

#### Create your bot YourBot.php class extended of \Prowebcraft\Telebot\Telebot
``` php
<?php

class YourBot extends \Prowebcraft\Telebot\Telebot
{

}

Create some public methods with Command suffix

/**
* Welcome message based on context
*/
public function hiCommand()
{
    if ($this->isChatGroup()) {
        $this->reply('Hey everybody in this chat!');
    } else {
        $this->reply('Hello, human!');
    }
}

Run your bot in daemon mode.

Create daemon.php, <sub>(*9)</sub>

<?php

require_once './vendor/autoload.php';
require_once "YourBot.php";

$config = [];
$bot = new YourBot('YourBotName', []);
$bot->start();

And run it in console ``` bash $ php daemon.php, <sub>(*10)</sub>

At first run data.json will be created with some template options:

``` json
{
  "config": {
    "api": "TELEGRAM_BOT_API_KEY",
    "globalAdmin": 70863438,
    "admins": [],
    "trust": [],
    "whiteGroups": []
  }
}

Set your bot token to config.api, <sub>(*11)</sub>

Set yourself as global admin (you can get your id from @identybot), <sub>(*12)</sub>

Send /hi to your bot, <sub>(*13)</sub>

Credits

• Andrey Mistulov
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*14)</sub>