This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.

Telegram provider for Laravel Socialite

v2.0.2 2020-06-02 17:03 UTC

This package is auto-updated.

Last update: 2021-09-30 19:49:23 UTC


Style Status Latest Stable Version


Telegram provider for Laravel Socialite


composer require max13/telegram-socialite


First of all, you must create a bot by contacting @BotFather (

Don't forget to set your website URL using /setdomain

Then, as required by Laravel Socialite, you need to add your bot's configuration to config/services.php. The bot username is required, client_id must be null. The provider will also ask permission for the bot to write to the user.

'telegram' => [
    'client_id' => null,
    'client_secret' => env('TELEGRAM_TOKEN'),
    'redirect' => '/login/telegram/callback',


Now, Telegram is technically using OAuth, but not the usual workflow.

First or all, you must add a javascript to your page, anywhere you want (in the <head> or bottom of page) with this snippet:

{!! Socialite::driver('telegram')->getScript() !!}

You also must call _TWidgetLogin.auth() on click on your login button, which will open a popup showing the Telegram OAuth access request. Because of browser's security, you can't automatically call this, it must be called as a result of a user's action.

If the user accept the access request, the browser is redirected to your services.telegram.redirect config key and you will have access to the logged-in user data the classic Socialite way:


If the user declines, an InvalidArgumentException exception will be thrown.

Using Socialite::driver('telegram')->redirect() will abort the connection with a 404 error.

If you want to see the Telegram Widget configuration page: