Full-Screen Message Effects
Trigger full-screen celebration fireworks, flames, and hearts using message_effect_id.
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
]);
}