# Telegram

composer require socialiteproviders/telegram

# Installation & Basic Usage

Please see the Base Installation Guide, then follow the provider specific instructions below.

# Configuration

First of all, you must create a bot by contacting @BotFather (https://core.telegram.org/bots#6-botfather)

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

Then, 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' => [
    'bot' => env('TELEGRAM_BOT_NAME'),  // The bot's username
    'client_id' => null,
    'client_secret' => env('TELEGRAM_TOKEN'),
    'redirect' => env('TELEGRAM_REDIRECT_URI'),
],

# Add provider event listener

Configure the package's listener to listen for SocialiteWasCalled events.

Add the event to your listen[] array in app/Providers/EventServiceProvider. See the Base Installation Guide for detailed instructions.

protected $listen = [
    \SocialiteProviders\Manager\SocialiteWasCalled::class => [
        // ... other providers
        'SocialiteProviders\\Telegram\\TelegramExtendSocialite@handle',
    ],
];

# Usage

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:

Socialite::driver('telegram')->user();

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

Using Socialite::driver('telegram')->redirect() will show you a blank page with only the login button.

If you want to see the Telegram Widget configuration page: https://core.telegram.org/widgets/login