<p>Custom emojis are a special kind of <ahref="/api/entities">entity »</a>, containing just a <code>document_id</code>, which can be passed to <ahref="/method/messages.getCustomEmojiDocuments">messages.getCustomEmojiDocuments</a> to fetch the <ahref="/api/stickers">static, animated or video sticker emoji</a> that should be displayed to the user as described in the <ahref="/api/stickers">stickers documentation</a>. </p>
<p>Custom emoji documents will contain <ahref="/constructor/documentAttributeCustomEmoji">documentAttributeCustomEmoji</a> attribute instead of a <ahref="/constructor/documentAttributeSticker">documentAttributeSticker</a>, containing information on the associated emoji (<code>alt</code>), whether the emoji can be used by non-premium users (<code>free</code>) and the associated <code>stickerset</code>.</p>
<p>Note that when sending messages with attached custom emojis, the <ahref="/constructor/messageEntityCustomEmoji">messageEntityCustomEmoji</a><ahref="/api/entities">entity »</a> must wrap exactly one regular emoji (the one contained in <ahref="/constructor/documentAttributeCustomEmoji">documentAttributeCustomEmoji</a>.<code>alt</code>) in the related text, otherwise the server will ignore it. </p>
<p>Like stickers, custom emojis are organized in <ahref="/api/stickers#stickersets">stickersets</a>: see the <ahref="/api/stickers">stickers documentation »</a> for more info on how to work with them.</p>
<p>To send a message with one or more custom emojis, create and attach <ahref="/constructor/messageEntityCustomEmoji">messageEntityCustomEmoji</a><ahref="/api/entities">entities »</a> to a message.<br>
Note that you can attach a maximum of <code>message_animated_emoji_max</code> custom emojis, as specified by the <ahref="/api/config#message-animated-emoji-max">appConfig field »</a>.</p></div>
</div>
</div>
</div>
<divclass="footer_wrap">
<divclass="footer_columns_wrap footer_desktop">
<divclass="footer_column footer_column_telegram">
<h5>Telegram</h5>
<divclass="footer_telegram_description"></div>
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.