README

A symfony wrapper bundle for Telegram Bot API.

Install

Via Composer

composer require ericomgroup/telegram-bot-api-bundle

Configure the bundle

This bundle was designed to just work out of the box. The only thing you have to configure in order to get this bundle up and running is your bot token.

# config/packages/telegram.yaml

telegram_bot_api:
    # Proxy (optional) :
    proxy: 'socks5h://127.0.0.1:5090' # this is example you have to change this
    async_requests: false

    # Development section:
    development:
        # Telegram user_id of developers accounts
        developers_id: [1234567, 87654321]
        # If this mode is enabled, the robot only responds to the developers
        maintenance:
            enable: true
            text: "The robot is being repaired! Please come back later."

    # Bots:
    bots:
        # The bot name
        first:
            # Your bot token: (required)
            token: 123456789:ABCD1234****4321CBA
        second:
            # Your bot token: (required)
            token: 123456789:ABCD1234****4321CBA
    
    # The default bot returned when you call getBot()
    default: 'second'

Usage

You can access the bot in the controller with :

    use EricomGroup\TelegramBotApiBundle\Service\Bot;

    ...

    public function index(Bot $bot)
    {
        $firstBot = $bot->getBot('first');
        $firstBot->getMe();
    }

In order to receive updates via a Webhook, You first need to tell your webhook URL to Telegram. You can use setWebhook method to specify a url and receive incoming updates via an outgoing webhook.

Once you set the webhook using the setWebhook method, You can then use the below function to retrieve the updates that are sent to your Webhook URL. The function returns an array of Update objects.

    $updateArray = $firstBot()->getWebhookUpdates();

Next...

Please refer to Telegram Bot API Official Document for getting information about available methods and other informations.

Troubleshooting

If you did all the configurations correctly but still getting errors (Http error 500) even on getMe() method, it might be because of SSL Verification. Please make sure you have up-to-date CA root certificate bundle to be used with cURL.

You can configure you CA root certificate bundle by:

Downloading up-to-date cacert.pem file from cURL website and
Setting a path to it in your php.ini file, e.g. on Windows:

curl.cainfo=c:\php\cacert.pem

You can test your SSL-setup online with this handy webtool on: SSL Labs

License

The MIT License (MIT). Please see License File for more information.

ericomgroup / telegram-bot-api-bundle

Maintainers

Details