How Telegram Mini Apps Set Emoji Status: Dynamic Game Presence, Spotify/Media Sync & Automated Status APIs
Broadcast what you are doing in real time across all chats. Discover how Telegram Mini Apps allow Premium users to set custom animated emoji statuses, delegate automated status changes when listening to music, watching movies, or entering location zones, and build dynamic presence ecosystems.
Mini apps automatically update your profile status with in-game badges or animated icons while you are actively playing.
Connect music and streaming Mini Apps to dynamically reflect what tracks you are listening to or movies you are watching.
Combine location permissions with status automation to seamlessly switch from at work 💼 to on vacation 🧳 automatically.
electric_bolt Overview: From Static Icons to Intelligent Presence
developer_mode Developer SDK: requestEmojiStatusAccess & setEmojiStatus
// 1. Request permission to manage user's emoji status
window.Telegram.WebApp.requestEmojiStatusAccess(function(granted) {
if (granted) {
// 2. Set animated emoji status with custom duration (e.g. 1 hour)
window.Telegram.WebApp.setEmojiStatus(
"538291048201948102", // Custom Emoji Document ID
{ duration: 3600 }, // 3600 seconds = 1 hour
function(success) {
if (success) {
console.log("Emoji status successfully updated!");
}
}
);
}
});workspaces Popular Real-World Use Cases
Gaming Guild Badges & Rank Displays
RPGs and Web3 games can award animated status badges representing a player's guild affiliation, tournament victory, or elite VIP tier, visible to every contact in Telegram chat lists.
Music & Podcast Scrobblers
Music Mini Apps can sync with Spotify or Apple Music to place an animated equalizer or music note next to your name with a countdown matching the song duration.
Calendar & Productivity Automations
Productivity Mini Apps can monitor your Google Calendar or Outlook and switch your status to “In a Meeting 🗓️” or “Do Not Disturb ⛔” automatically.
Select different Mini App activity presets to preview how your profile badge renders in Telegram chat lists and message headers.
help Frequently Asked Questions
Yes. Displaying custom animated emoji statuses next to user profiles is an exclusive Telegram Premium feature. If a free user interacts with an emoji status prompt in a Mini App, Telegram will present a promotional sheet explaining the Premium benefit.
Yes. You can manage or revoke emoji status permissions at any time in Settings > Privacy and Security > Bots and Websites, or by tapping on your current emoji status in your profile and selecting “Clear Status”.
