The Javascript SDK helps you easily integrate Telegram Passport requests into your website. Check out our GitHub repository to see samples using this SDK.
Download and include the Javascript SDK in the head section of your page:
<script src="telegram-passport.js"></script>Simply call Telegram.Passport.createAuthButton to create the default Telegram Passport button:
<div id="telegram_passport_auth"></div>
<script>
Telegram.Passport.createAuthButton('telegram_passport_auth', {
bot_id: 123456, // place id of your bot here
scope: {data: [{type: 'id_document', selfie: true}, 'address_document', 'phone_number', 'email'], v: 1},
public_key: '-----BEGIN PUBLIC KEY----- ...', // place public key of your bot here
nonce: 'ab2df83746a87d2f3bd6...', // place nonce here
callback_url: 'https://example.com/callback/' // place callback url here
});
</script>Note that if you use a Content-Security-Policy (CSP) header with the frame-src/child-src directive you should allow
tg:source to prevent errors in some browsers (e.g. Firefox)
| Parameters | Type | Required |
| element | String or DOMNode | Yes |
| auth_params | AuthParameters or Function | Yes |
| options | AuthButtonOptions | Optional |
| Field | Type | Description |
| bot_id | Integer | Unique identifier for the bot |
| scope | PassportScope | A JSON-serialized object describing the data you want to request |
| public_key | String | Public key of your bot |
| nonce | String | Bot-specified nonce |
| callback_url | String | Optional. URL to which the user will be redirected. |
| Field | Type | Description |
| text | String | Optional. Text on the button. Defaults to "Log In With Telegram". |
| radius | Integer | Optional. Radius of the button and tooltip in px. Defaults to 23. |
| tooltip_text | String | Optional. Text on the tooltip. Defaults to "Please install Telegram to use this option.". |
| tooltip_position | String | Optional. Tooltip position. One of "top", "bottom", "left", "right". Defaults to "bottom". |
| tooltip_force | Boolean | Optional. Always show a tooltip. Defaults to false. |
You can also create your custom button. Do not forget about the tooltip. You should add an onclick listener to the button which calls the Telegram.Passport.auth(auth_params, tooltip_toggle); method:
<button id="telegram_passport_auth">Log In With Telegram</button>
<script>
var auth_button = document.getElementById('telegram_passport_auth');
var auth_params = {
bot_id: XXXXXX, // place id of your bot here
scope: {data: [{type: 'id_document', selfie: true}, 'address_document', 'phone_number', 'email'], v: 1},
public_key: '-----BEGIN PUBLIC KEY----- ...', // place public key of your bot here
nonce: 'ab2df83746a87d2f3bd6...', // place nonce here
callback_url: 'https://example.com/callback/' // place callback url here
};
auth_button.addEventListener('click', function() {
Telegram.Passport.auth(auth_params, function(show) {
if (show) {
// some code to show tooltip
} else {
// some code to hide tooltip
}
});
}, false);
</script>When the user confirms your request by pressing the "Authorize" button, it will be redirected to the URL specified in the callback_url with the parameter tg_passport=success and the Bot API will send the bot an Update with the field passport_data which contains encrypted Telegram Passport data.
If the user cancels your request, it will be redirected to the URL specified in the callback_url with the parameter tg_passport=cancel.
If an error occurs during the request, the user will be redirected to the URL specified in the callback_url with the parameter tg_passport=error. The parameter error will contain one of the following values: BOT_INVALID, PUBLIC_KEY_REQUIRED, PUBLIC_KEY_INVALID, SCOPE_EMPTY, NONCE_EMPTY.