# deleteMessage

> Use this method to delete a message, including service messages, with the following limitations: - A message can only be deleted if it was s

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

---

**Botlify Native Shorthand:**
  `tg_delete($chatId, $messageId);`
  Deletes a message instantly from any chat or channel. See [Native Helpers Guide](?page=tg-native-helpers).
 

Use this method to delete a message, including service messages, with the following limitations:

- A message can only be deleted if it was sent less than 48 hours ago.

- Service messages about a supergroup, channel, or forum topic creation can't be deleted.

- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.

- Bots can delete outgoing messages in private chats, groups, and supergroups.

- Bots can delete incoming messages in private chats.

- Bots granted *can_post_messages* permissions can delete outgoing messages in channels.

- If the bot is an administrator of a group, it can delete any message there.

- If the bot has *can_delete_messages* administrator right in a supergroup or a channel, it can delete any message there.

- If the bot has *can_manage_direct_messages* administrator right in a channel, it can delete any message in the corresponding direct messages chat.

Returns *True* on success.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| chat_id | Integer or String | Yes | Unique identifier for the target chat or username of the target bot, supergroup or channel in the format @username |
| message_id | Integer | Yes | Identifier of the message to delete |

## Example

```php

```

> [!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.