editEphemeralMessageCaption

Raw MD
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

ParameterTypeRequiredDescription
chat_idInteger or StringYesUnique identifier for the target chat or username of the target supergroup in the format @username
receiver_user_idIntegerYesIdentifier of the user who received the message
ephemeral_message_idIntegerYesIdentifier of the ephemeral message to edit
captionStringOptionalNew caption of the message, 0-1024 characters after entities parsing
parse_modeStringOptionalMode for parsing entities in the message caption. See formatting options for more details.
caption_entitiesArray of MessageEntityOptionalA JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode
show_caption_above_mediaBooleanOptionalPass True if the caption must be shown above the message media. Supported only for animation, photo and video messages.
reply_markupInlineKeyboardMarkupOptionalA 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 .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.