# Full-Screen Message Effects

> Trigger full-screen celebration fireworks, flames, and hearts using message_effect_id.

**Category:** Telegram Bot API — Methods (A-Z)  
**URL:** https://docs.botlify.cloud/message-effects  
**Platform:** Botlify Cloud (https://botlify.cloud)  

---

## 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. |

   

   
```php
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
    ]);
}
```

> [!TIP]
> **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.
