Full-Screen Message Effects

Raw MD
Trigger full-screen celebration fireworks, flames, and hearts using message_effect_id.
2 min read Botlify Cloud Updated October 2026

The message_effect_id Parameter

Telegram Bot API 8.x introduced full-screen animation effects that cover the entire chat screen when a message arrives. Use the message_effect_id parameter in sendMessage.

Effect ID Animation Type Best Used For
5046509860389126442 🎉 Celebration & Confetti Welcome bonuses, payment completions, winning rewards.
5104841245755180586 🔥 Burning Flames Level ups, high streaks, hot broadcasts.
5107584321108051014 ❤️ Floating Hearts Thank you messages, donations, gifts.
5104858069142078847 👍 Thumbs Up Explosion Approvals, confirmed orders, task completions.
send_effect Helper 
function send_effect(string|int $chatId, string $text, string $effectId = '5046509860389126442'): array {
    return bot('sendMessage', [
        'chat_id'           => $chatId,
        'text'              => $text,
        'parse_mode'        => 'HTML',
        'message_effect_id' => $effectId
    ]);
}
Botlify Cloud Runtime
Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.