editEphemeralMessageCaption
Use this method to edit the caption of an ephemeral message
Use this method to edit the caption of an ephemeral message. Note that it is not guaranteed that the user will receive the message edit event, especially if they are offline. On success, True is returned.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
chat_id | Integer or String | Yes | Unique identifier for the target chat or username of the target supergroup in the format @username |
receiver_user_id | Integer | Yes | Identifier of the user who received the message |
ephemeral_message_id | Integer | Yes | Identifier of the ephemeral message to edit |
caption | String | Optional | New caption of the message, 0-1024 characters after entities parsing |
parse_mode | String | Optional | Mode for parsing entities in the message caption. See formatting options for more details. |
caption_entities | Array of MessageEntity | Optional | A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode |
show_caption_above_media | Boolean | Optional | Pass True if the caption must be shown above the message media. Supported only for animation, photo and video messages. |
reply_markup | InlineKeyboardMarkup | Optional | A JSON-serialized object for an inline keyboard |
Example
PHP — Call editEphemeralMessageCaption on Botlify Cloud
<?php
// ── Botlify Cloud .env — auto-injected, never hardcode secrets ──
$BOT_TOKEN = getenv('BOT_TOKEN'); // Telegram bot token from @BotFather
$ADMIN_CHAT_ID = getenv('ADMIN_CHAT_ID'); // Your numeric admin Telegram user ID
$BOT_USERNAME = getenv('BOT_USERNAME'); // Bot username without @
$resp = bot('editEphemeralMessageCaption', [
'chat_id' => $chatId,
'receiver_user_id' => $userId,
'ephemeral_message_id' => $messageId,
]);
if ($resp['ok'] ?? false) {
$result = $resp['result']; // handle the response
}Botlify Cloud Runtime
Credentials are auto-injected in
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.