Messages, Editing, Pinning & Rich Text Formatting

<?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 @

declare(strict_types=1);

bot('sendMessage', [
    'chat_id'              => $chatId,
    'text'                 => "🚀 Botlify Cloud v2.5 Released!\n\nCheck out our high-speed SQLite WAL engine at https://botlify.cloud\n\nEnjoy zero-config deployment!",
    'parse_mode'           => 'HTML',
    'protect_content'      => false, // Set true to forbid forwarding & screenshots
    'link_preview_options' => [
        'is_disabled'       => false,
        'url'               => 'https://botlify.cloud',
        'prefer_large_media'=> true,
        'show_above_text'   => false // Place preview thumbnail below text
    ],
    'reply_parameters'     => [
        'message_id' => $incomingMessageId // Quote user message
    ]
]);

<?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 @

declare(strict_types=1);

$richHtml = <<<'RAW_HTML'
⚡ Botlify Cloud Server Report

Server Status: Operational
Uptime: 99.98% | Load: 0.12, 0.08, 0.04


Detailed Diagnostic Metrics:
• Database: SQLite 3 WAL Mode (-32MB cache)
• Peak Response Time: 18ms
• Active Webhook Sockets: 4,120
• SSL Handshake: TLSv1.3 Perfect Forward Secrecy


Your security key is: SEC-9842-ALPHA-77

To update your runtime settings, run:
php api/v1 --restart


{
  "status": "healthy",
  "engine": "Botlify Cloud 20ms",
  "mcp_ready": true
}


Need help? Contact Platform Support or browse Documentation.
RAW_HTML;

bot('sendMessage', [
  'chat_id'  => $chatId,
  'text'    => $richHtml,
  'parse_mode' => 'HTML'
]);

<?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 @

declare(strict_types=1);

// 1. Edit Text Message
function update_chat_screen(string|int $chatId, int $messageId, string $newHtml, array $newKeyboard = []): void {
    bot('editMessageText', [
        'chat_id'      => $chatId,
        'message_id'   => $messageId,
        'text'         => $newHtml,
        'parse_mode'   => 'HTML',
        'reply_markup' => !empty($newKeyboard) ? $newKeyboard : null
    ]);
}

// 2. Edit Media Caption (for Photos, Videos, Documents)
function update_photo_caption(string|int $chatId, int $messageId, string $newCaption): void {
    bot('editMessageCaption', [
        'chat_id'    => $chatId,
        'message_id' => $messageId,
        'caption'    => $newCaption,
        'parse_mode' => 'HTML'
    ]);
}

// 3. Edit Only the Inline Keyboard Below a Message
function update_buttons_only(string|int $chatId, int $messageId, array $keyboard): void {
    bot('editMessageReplyMarkup', [
        'chat_id'      => $chatId,
        'message_id'   => $messageId,
        'reply_markup' => $keyboard
    ]);
}

<?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 @

declare(strict_types=1);

// 1. Delete a Single Message (Clean up command /start or spam)
bot('deleteMessage', [
    'chat_id'    => $chatId,
    'message_id' => $incomingMessageId
]);

// 2. Batch Delete Multiple Messages (API 7.0+)
bot('deleteMessages', [
    'chat_id'     => $chatId,
    'message_ids' => [$msgId1, $msgId2, $msgId3]
]);

// 3. Pin Message as Announcement
bot('pinChatMessage', [
    'chat_id'              => $chatId,
    'message_id'           => $announcementMsgId,
    'disable_notification' => false // Send push notification to all members
]);

// 4. Unpin Messages
bot('unpinChatMessage', ['chat_id' => $chatId, 'message_id' => $announcementMsgId]);
bot('unpinAllChatMessages', ['chat_id' => $chatId]);

// 5. copyMessage (Superior to forwardMessage: strips author header & customizes caption)
bot('copyMessage', [
    'chat_id'      => $targetChatId,
    'from_chat_id' => $sourceChatId,
    'message_id'   => $sourceMsgId,
    'caption'      => '📢 Official Broadcast via Botlify Cloud',
    'parse_mode'   => 'HTML'
]);

<?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 @

declare(strict_types=1);

// Send typing indicator while generating response
bot('sendChatAction', [
    'chat_id' => $chatId,
    'action'  => 'typing'
]);

// In forum topics, pass message_thread_id
if (!empty($threadId)) {
    bot('sendChatAction', [
        'chat_id'           => $chatId,
        'message_thread_id' => $threadId,
        'action'            => 'upload_document'
    ]);
}

<?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 @

declare(strict_types=1);

function stream_ai_draft(string|int $chatId, string $partialText, bool $canStop = true): void {
    bot('sendMessageDraft', [
        'chat_id'      => $chatId,
        'text'         => $partialText,
        'can_stop'     => $canStop,      // Displays native "Stop Generating" button
        'keep_on_stop' => true           // Keeps text generated so far if user stops
    ]);
}

// Handling Stopped Generation Update
if (isset($update['stopped_message_generation'])) {
    $stopData = $update['stopped_message_generation'];
    $userId = $stopData['user']['id'];
    error_log("User {$userId} aborted AI text generation.");
    http_response_code(200);
    exit;
}