<metaproperty="description"content="Telegram users can make it easy for others to contact them or find their public groups and channels via usernames: clients can also assign multiple Fragment &raquo; collectible usernames to accounts, supergroups and channels they own; Fragment &raquo; also allows purchasing phone number collectibles that can be used to register Telegram accounts.">
<metaproperty="og:description"content="Telegram users can make it easy for others to contact them or find their public groups and channels via usernames: clients can also assign multiple Fragment &raquo; collectible usernames to accounts, supergroups and channels they own; Fragment &raquo; also allows purchasing phone number collectibles that can be used to register Telegram accounts.">
<p>Telegram users can make it easy for others to contact them or find their public groups and channels via <ahref="https://telegram.org/faq#usernames-and-t-me">usernames</a>: clients can also assign multiple <ahref="https://fragment.com">Fragment»</a><strong>collectible usernames</strong> to accounts, supergroups and channels they own; <ahref="https://fragment.com">Fragment»</a> also allows purchasing phone number collectibles that can be used to register Telegram accounts. </p>
<p>Collectible usernames work just like basic <ahref="https://t.me/username">@usernames</a>, they appear in Global Search results and have <ahref="/api/links#public-username-links">deep links»</a>, just like basic usernames. </p>
<p>The ownership of collectible usernames is secured by TON, a fast and scalable blockchain network. They can be bought and sold through the <ahref="https://fragment.com">Fragment platform»</a>, giving a simple and secure way to acquire and exchange valuable Telegram domains. </p>
<p>On the Fragment platform, clients may associate or dissociate purchased collectible usernames either to their Telegram account, or to a bot/channel/supergroup they own. </p>
<p>If any collectible username is associated to an account, channel or supergroup, <ahref="/constructor/user">user</a>.<code>username</code> and <ahref="/constructor/channel">channel</a>.<code>username</code> won't be set, and <ahref="/constructor/user">user</a>.<code>usernames</code> and <ahref="/constructor/channel">channel</a>.<code>usernames</code> will be set, instead: these fields contain an array of <ahref="/constructor/username">username</a> constructors, which indicate whether a certain username is a basic username (<code>editable</code> is set) or a collectible username (<code>editable</code> is not set); and whether a collectible username is <code>active</code> or not.<br>
The first username in the <code>usernames</code> vector must be shown in-UI as the main username.</p>
<p>Immediately after association, a username is marked as not <code>active</code> (i.e. only the owner can see it in the <code>usernames</code> list): use <ahref="/method/account.toggleUsername">account.toggleUsername</a>, <ahref="/method/bots.toggleUsername">bots.toggleUsername</a> or <ahref="/method/channels.toggleUsername">channels.toggleUsername</a> to mark it as active.<br>
Note that you can't mark as inactive the basic (non-collectible) username, if any. </p>
<p><ahref="/method/channels.deactivateAllUsernames">channels.deactivateAllUsernames</a> may also be used to mark as inactive all collectible usernames associated to a certain supergroup or channel: useful for example when making a group or channel private, by first invoking <ahref="/method/channels.updateUsername">channels.updateUsername</a> with an empty username to remove the editable username (if present), and then invoking this method to remove all associated collectible usernames. </p>
<p>Use <ahref="/method/account.reorderUsernames">account.reorderUsernames</a>/<ahref="/method/bots.reorderUsernames">bots.reorderUsernames</a>/<ahref="/method/channels.reorderUsernames">channels.reorderUsernames</a> to change the order of the usernames associated to an account, channel or supergroup: all currently active usernames must be specified. </p>
<p><ahref="https://fragment.com">Fragment</a> collectible phone numbers can only be used to create Telegram accounts, using the usual <ahref="/api/auth">sign up/login flow»</a>.</p>
<h3><aclass="anchor"href="#fetching-info-about-fragment-collectibles"id="fetching-info-about-fragment-collectibles"name="fetching-info-about-fragment-collectibles"><iclass="anchor-icon"></i></a>Fetching info about Fragment collectibles</h3>
<p><ahref="/method/fragment.getCollectibleInfo">fragment.getCollectibleInfo</a> may be used to fetch info about <ahref="https://fragment.com">Fragment</a> collectible owned by us or other users (i.e. the purchase date & price). </p>
<p>The collectible must be visible to the current user, for example it can be a Fragment user/phone number collectible we own, or a Fragment username that another user has enabled on their account, or another user's Fragment phone number that we can see thanks to the owner's <ahref="/api/privacy">privacy settings</a>.</p></div>
