telegram-crawler/data/web/core.telegram.org/gateway.html
2024-10-14 16:27:12 +00:00

192 lines
14 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html class="">
<head>
<meta charset="utf-8">
<title>Telegram Gateway</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta property="description" content="Verify phone numbers of your users for just &#036;0.01 per code through Telegram Gateway.">
<meta property="og:title" content="Telegram Gateway">
<meta property="og:image" content="https://telegram.org/file/400780400999/1/RY61waDfzk8.145353/8e8983917690b3b6dd">
<meta property="og:description" content="Verify phone numbers of your users for just &#036;0.01 per code through Telegram Gateway.">
<link rel="icon" type="image/svg+xml" href="/img/website_icon.svg?4">
<link rel="apple-touch-icon" sizes="180x180" href="/img/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/img/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/img/favicon-16x16.png">
<link rel="alternate icon" href="/img/favicon.ico" type="image/x-icon" />
<link href="/css/bootstrap.min.css?3" rel="stylesheet">
<link href="/css/telegram.css?241" rel="stylesheet" media="screen">
<style>
</style>
</head>
<body class="preload">
<div class="dev_page_wrap">
<div class="dev_page_head navbar navbar-static-top navbar-tg">
<div class="navbar-inner">
<div class="container clearfix">
<ul class="nav navbar-nav navbar-right hidden-xs"><li class="navbar-twitter"><a href="https://twitter.com/telegram" target="_blank" data-track="Follow/Twitter" onclick="trackDlClick(this, event)"><i class="icon icon-twitter"></i><span> Twitter</span></a></li></ul>
<ul class="nav navbar-nav">
<li><a href="//telegram.org/">Home</a></li>
<li class="hidden-xs"><a href="//telegram.org/faq">FAQ</a></li>
<li class="hidden-xs"><a href="//telegram.org/apps">Apps</a></li>
<li class=""><a href="/api">API</a></li>
<li class=""><a href="/mtproto">Protocol</a></li>
<li class=""><a href="/schema">Schema</a></li>
</ul>
</div>
</div>
</div>
<div class="container clearfix">
<div class="dev_page">
<div id="dev_page_content_wrap" class=" ">
<div class="dev_page_bread_crumbs"></div>
<h1 id="dev_page_title">Telegram Gateway</h1>
<div id="dev_page_content"><p>Telegram Gateway is the cheapest way to verify phone numbers of users. It allows any service to send authorization codes through Telegram instead of traditional SMS offering a powerful and convenient way to <strong>lower costs</strong> while increasing the <strong>security</strong> and <strong>delivery speed</strong> of your codes to Telegrams 950+ million monthly active users. </p>
<div class="blog_video_player_wrap" style="max-width: 600px; margin: 20px auto 20px;">
<div><video class="blog_video_player tl_blog_vid_autoplay" onclick="videoTogglePlay(this)" autoplay loop controls muted poster="/file/400780400519/2/lNZQaAkJ9QM.37203/8f106e392d786abf8d" style="max-width: 600px;" alt="Verification platform">
<source src="/file/400780400123/3/z0SrtopuptI.1065086.mp4/0afe2583ac58fd6a35" type="video/mp4">
</video></div>
</div>
<p>This page will walk you through the main benefits and features of the <strong>Telegram Gateway</strong>.<br>For more information, see:</p>
<ul>
<li><a href="#faq">FAQ</a></li>
<li><a href="https://core.telegram.org/gateway/verification-tutorial"><strong>Quick-Start Guide</strong></a></li>
<li><a href="https://core.telegram.org/gateway/api">Full Gateway API Reference for Developers</a></li>
<li><a href="https://telegram.org/tos/gateway">Gateway API Terms of Service</a></li>
</ul>
<h3><a class="anchor" name="what-can-you-do-with-telegram-gateway" href="#what-can-you-do-with-telegram-gateway"><i class="anchor-icon"></i></a>What can you do with Telegram Gateway?</h3>
<ul>
<li><a href="#authenticate-users-anywhere">Authenticate Users Anywhere</a></li>
<li><a href="#reduce-acquisition-costs">Reduce Acquisition Costs</a></li>
<li><a href="#access-detailed-statistics">Access Detailed Statistics</a></li>
<li><a href="#deliver-messages-securely">Deliver Messages Securely</a></li>
<li><a href="#build-an-audience">Build an Audience</a></li>
</ul>
<h4><a class="anchor" name="authenticate-users-anywhere" href="#authenticate-users-anywhere"><i class="anchor-icon"></i></a>Authenticate Users Anywhere</h4>
<p>To access Telegram, registered users only need an internet connection. Thanks to the <strong>Telegram Verification Platform</strong>, accessible by developers via the <a href="https://core.telegram.org/gateway/api">Gateway API</a>, users can conveniently receive your message on <strong>mobile</strong> or <strong>desktop</strong>, without needing an active SMS plan from their provider.</p>
<div class="blog_image_wrap blog_wide_image_wrap">
<a href="/file/400780400656/3/9iBg_m8EjJs.349165/64ba1e8722d15e124d" target="_blank"><img src="/file/400780400056/4/dJCmmM9Kytg.150900/c5553bdb185c273b8f" title="" alt="Costs Per Message" srcset="/file/400780400656/3/9iBg_m8EjJs.349165/64ba1e8722d15e124d , 2x" /></a>
</div>
<h4><a class="anchor" name="reduce-acquisition-costs" href="#reduce-acquisition-costs"><i class="anchor-icon"></i></a>Reduce Acquisition Costs</h4>
<p>Verification via Telegram costs $0.01 per delivered code greatly reducing operating costs for your service. By comparison, SMS verification can cost up to <strong>50 times more</strong> per code.</p>
<p>The Telegram Verification Platform also <strong>ensures instant delivery</strong> of your messages unlike SMS, which can take several minutes to arrive and have failure rates as high as 5%.</p>
<div class="blog_image_wrap blog_wide_image_wrap">
<a href="/file/400780400658/1/KzqXYJ29JGs.45959/e1be634e32ae8b8f00" target="_blank"><img src="/file/400780400658/1/KzqXYJ29JGs.45959/e1be634e32ae8b8f00" title="" alt="Costs Per Message" srcset="/file/400780400658/1/KzqXYJ29JGs.45959/e1be634e32ae8b8f00 , 2x" /></a>
</div>
<h4><a class="anchor" name="access-detailed-statistics" href="#access-detailed-statistics"><i class="anchor-icon"></i></a>Access Detailed Statistics</h4>
<p>The Telegram Verification Platform shows <strong>detailed statistics</strong> to help you manage your budget and <strong>track message volume</strong> allowing you to <strong>analyze user growth</strong> and conversion rates.</p>
<div class="blog_image_wrap blog_wide_image_wrap">
<a href="/file/400780400146/1/3uChLsddQE4.79753/a4051359d04719de58" target="_blank"><img src="/file/400780400146/1/3uChLsddQE4.79753/a4051359d04719de58" title="" alt="Detailed Statistics" srcset="/file/400780400146/1/3uChLsddQE4.79753/a4051359d04719de58 , 2x" /></a>
</div>
<h4><a class="anchor" name="deliver-messages-securely" href="#deliver-messages-securely"><i class="anchor-icon"></i></a>Deliver Messages Securely</h4>
<p>Telegram offers a proven encryption protocol and open-source, verifiable apps. In contrast, traditional SMS methods are not encrypted (anyone can read them!) and susceptible to vulnerabilities such as carrier trust issues, sender forgery, and SIM swap attacks.</p>
<p>By using Telegram, you can significantly <strong>enhance security</strong> and guarantee a more <strong>robust</strong>, <strong>encrypted</strong>, and <strong>reliable</strong> authorization process.</p>
<h4><a class="anchor" name="build-an-audience" href="#build-an-audience"><i class="anchor-icon"></i></a>Build an Audience</h4>
<p>Telegram is one of the <strong>top 5 most-downloaded apps</strong> in the world, with over 950 million users and robust features for companies and content creators giving you the tools to scale your business in new markets.</p>
<div class="blog_image_wrap blog_wide_image_wrap">
<a href="/file/400780400031/4/O9Jsl42ber0.98383/bfc2ac7805965d98a0" target="_blank"><img src="/file/400780400031/4/O9Jsl42ber0.98383/bfc2ac7805965d98a0" title="" alt="Telegram User Base Growth" srcset="/file/400780400031/4/O9Jsl42ber0.98383/bfc2ac7805965d98a0 , 2x" /></a>
</div>
<p>Messages you send with the Gateway API can be signed by a <a href="https://telegram.org/verify">verified</a> channel on Telegram, helping users find updates and support.</p>
<h4><a class="anchor" name="faq" href="#faq"><i class="anchor-icon"></i></a>FAQ</h4>
<h5><a class="anchor" name="q-who-provides-the-contact-number-for-users" href="#q-who-provides-the-contact-number-for-users"><i class="anchor-icon"></i></a>Q: Who provides the contact number for users?</h5>
<p>Services using the Gateway API must provide the relevant phone number for each message they send. All phone numbers they use must be from users who <strong>voluntarily shared their number</strong> with the service in order to receive messages to their registered Telegram account.</p>
<blockquote>
<p>Telegram <strong>does not disclose user phone numbers</strong> to services that utilize the Telegram Verification Platform.</p>
</blockquote>
<h5><a class="anchor" name="q-do-my-users-need-to-opt-in-to-receive-my-messages" href="#q-do-my-users-need-to-opt-in-to-receive-my-messages"><i class="anchor-icon"></i></a>Q: Do my users need to opt-in to receive my messages?</h5>
<p>Yes. The registered phone numbers of Telegram users are <strong>always private</strong> so users must <strong>voluntarily opt-in</strong> by sharing their phone number with your service and agreeing to receive your messages on Telegram.</p>
<h5><a class="anchor" name="q-what-phone-number-format-should-i-use" href="#q-what-phone-number-format-should-i-use"><i class="anchor-icon"></i></a>Q: What phone number format should I use?</h5>
<p>All phone numbers should be provided in <a href="https://en.wikipedia.org/wiki/E.164">E.164 format</a>.</p>
<h5><a class="anchor" name="q-how-can-i-test-my-authorization-flow" href="#q-how-can-i-test-my-authorization-flow"><i class="anchor-icon"></i></a>Q: How can I test my authorization flow?</h5>
<p>To test the Gateway API, you can simply send codes to your own phone number on Telegram all messages to yourself are <strong>free of charge</strong>.</p>
<h5><a class="anchor" name="q-can-i-transfer-funds-between-gateway-accounts" href="#q-can-i-transfer-funds-between-gateway-accounts"><i class="anchor-icon"></i></a>Q: Can I transfer funds between Gateway accounts?</h5>
<p>No, transferring funds between Verification Platform accounts is currently not supported. All funds transferred to your account constitute advance-paid credits and cannot be transferred or withdrawn.</p>
<blockquote>
<p>For more information, please reference <a href="https://telegram.org/tos/gateway#3-1-balance">Section 3.1.</a> of the <a href="https://telegram.org/tos/gateway">Verification Platform Terms of Service</a>.</p>
</blockquote>
<h5><a class="anchor" name="q-how-do-i-check-if-a-user-can-receive-my-messages-on-telegram" href="#q-how-do-i-check-if-a-user-can-receive-my-messages-on-telegram"><i class="anchor-icon"></i></a>Q: How do I check if a user can receive my messages on Telegram?</h5>
<p>You can use the <a href="https://core.telegram.org/gateway/api#checksendability">checkSendAbility</a> method to check if a user can receive your messages on Telegram. If they cannot, your request will be free of charge.</p>
<blockquote>
<p>More details on how pricing works for checks and actual requests are available <a href="https://core.telegram.org/gateway/api#checksendability">in the documentation</a>.</p>
<div></blockquote>
</div>
</div>
</div>
</div>
<div class="footer_wrap">
<div class="footer_columns_wrap footer_desktop">
<div class="footer_column footer_column_telegram">
<h5>Telegram</h5>
<div class="footer_telegram_description"></div>
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
</div>
<div class="footer_column">
<h5><a href="//telegram.org/faq">About</a></h5>
<ul>
<li><a href="//telegram.org/faq">FAQ</a></li>
<li><a href="//telegram.org/privacy">Privacy</a></li>
<li><a href="//telegram.org/press">Press</a></li>
</ul>
</div>
<div class="footer_column">
<h5><a href="//telegram.org/apps#mobile-apps">Mobile Apps</a></h5>
<ul>
<li><a href="//telegram.org/dl/ios">iPhone/iPad</a></li>
<li><a href="//telegram.org/android">Android</a></li>
<li><a href="//telegram.org/dl/web">Mobile Web</a></li>
</ul>
</div>
<div class="footer_column">
<h5><a href="//telegram.org/apps#desktop-apps">Desktop Apps</a></h5>
<ul>
<li><a href="//desktop.telegram.org/">PC/Mac/Linux</a></li>
<li><a href="//macos.telegram.org/">macOS</a></li>
<li><a href="//telegram.org/dl/web">Web-browser</a></li>
</ul>
</div>
<div class="footer_column footer_column_platform">
<h5><a href="/">Platform</a></h5>
<ul>
<li><a href="/api">API</a></li>
<li><a href="//translations.telegram.org/">Translations</a></li>
<li><a href="//instantview.telegram.org/">Instant View</a></li>
</ul>
</div>
</div>
<div class="footer_columns_wrap footer_mobile">
<div class="footer_column">
<h5><a href="//telegram.org/faq">About</a></h5>
</div>
<div class="footer_column">
<h5><a href="//telegram.org/blog">Blog</a></h5>
</div>
<div class="footer_column">
<h5><a href="//telegram.org/apps">Apps</a></h5>
</div>
<div class="footer_column">
<h5><a href="/">Platform</a></h5>
</div>
<div class="footer_column">
<h5><a href="//telegram.org/press">Press</a></h5>
</div>
</div>
</div>
</div>
<script src="/js/main.js?47"></script>
<script>initScrollVideos(true);
backToTopInit("Go up");
removePreloadInit();
</script>
</body>
</html>