stajor/telegram-bot

Telegram Bot

PHP Telgram Bot API

PHP wrapper for Telegram's Bot API., _(*1)

, _(*2)

Installation

Add this line to your application's composer.json:, _(*3)

{
    "require": {
        "stajor/telegram-bot": "^3.0"
    }
}

and run composer update, _(*4)

Or run this command in your command line:, _(*5)

$ composer require stajor/telegram-bot

Telegram API support

All types and methods of the Telegram Bot API 3.6 are supported., _(*6)

Configuration

First of all you need create your own bot and obtain a token, _(*7)

How do I create a bot?, _(*8)

Usage

You can use Telegram::Bot::Api standalone, _(*9)

<?php

$api = new \Telegram\Bot\Api('BOT TOKEN');
$user = $api->getMe();

Or by using CommandsHandler to receive updates from Telegram, _(*10)

Create command class, _(*11)

<?php

use Telegram\Bot\Command;

class StartCommand extends Command {
    /**
     * @var string Command Name
     */
    protected $name = "start";

    /**
     * @var string Command Description
     */
    protected $description = "Start Command to get you started";

    /**
     * @inheritdoc
     */
    public function handle() {
        // This will send a message using `sendMessage`
        $this->replyWithMessage(['text' => 'Welcome to my Bot']);

        // Trigger another command dynamically from within this command
        $this->triggerCommand('help');
    }
}

In your controller add, _(*12)

<?php

$handler = new CommandsHandler('BOT TOKEN');
$handler->addCommand(StartCommand::class);
$handler->handle();

Send Photo

$api = new \Telegram\Bot\Api('BOT TOKEN');
$api->sendPhoto(['chat_id' => 123,'photo' => fopen('path_to_photo', 'rb')]);

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/Stajor/telegram-bot. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct., _(*13)

License

The gem is available as open source under the terms of the MIT License., _(*14)