TelegramBotBundle

Telegram bot bundle on top of telegram-bot/api library

Installation

Composer

$ composer require boshurik/telegram-bot-bundle

Register the bundle

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new BoShurik\TelegramBotBundle\BoShurikTelegramBotBundle,
    );
    // ...
}

Add routing for webhook

BoShurikTelegramBotBundle:
    resource: "@BoShurikTelegramBotBundle/Resources/config/routing.yml"
    prefix: /_telegram/<some-secret>

Configuration

bo_shurik_telegram_bot:
    api:
        token: "%telegram_bot_api_token%"
    name: "%telegram_bot_name%"

Usage

API

    /** @var TelegramBot\Api\BotApi $api */
    $api = $this->container->get('bo_shurik_telegram_bot.api');

For more info see Usage section in telegram-bot/api library

Getting updates

bin/console telegram:updates

For more information see official documentation

Webhook

Set

bin/console telegram:webhook [<url>] [<path-to-certificate>]

Unset

bin/console telegram:webhook

For more information see official documentation

Adding commands

Commands must implement \BoShurik\TelegramBotBundle\Telegram\Command\CommandInterface

There is \BoShurik\TelegramBotBundle\Telegram\Command\AbstractCommand you can start with

To register command: add tag bo_shurik_telegram_bot.command to service definition

app.telegram.command:
    class: AppBundle/Telegram/Command/SomeCommand
    tags:
        - { name: bo_shurik_telegram_bot.command }

There is predefined \BoShurik\TelegramBotBundle\Telegram\Command\HelpCommand. You need to register it:

app.telegram.command.help:
    class: BoShurik\TelegramBotBundle\Telegram\Command\HelpCommand
    arguments:
        - "@bo_shurik_telegram_bot.command_pool"
    tags:
        - { name: bo_shurik_telegram_bot.command }

Events

For more complex application (e.g. conversations) you can listen for TelegramEvents::UPDATE event

/**
 * @param UpdateEvent $event
 */
public function onUpdate(UpdateEvent $event)
{
    $update = $event->getUpdate();
    $message = $update->getMessage();
}

Example