PHP Telegram Bot：实现交互式回调数据处理-php教程-PHP中文网

PHP Telegram Bot：实现交互式回调数据处理

花韻仙語

发布： 2025-09-26 09:55:14

原创

162人浏览过

PHP Telegram Bot：实现交互式回调数据处理

本教程旨在指导开发者如何使用 PHP 和 Telegram Bot API 实现交互式回调数据处理。通过设置Webhook、构建内联键盘按钮并附加回调数据，以及解析和响应用户的回调查询，您可以创建更具动态性和用户友好性的Telegram机器人，从而实现如引导用户输入特定信息等复杂交互流程。

1. Webhook 配置：接收 Telegram 更新

要使您的 telegram bot 能够接收用户消息和交互，您需要配置一个 webhook。webhook 是一个 url，当有新事件发生时（例如用户发送消息或点击按钮），telegram 会将更新数据发送到这个 url。

重要提示： 您的 Webhook URL 必须使用 HTTPS 协议。

使用以下命令设置您的 Webhook：

https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook?url=https://yourdomain.com/path/to/your_bot.php

登录后复制

请将 zuojiankuohaophpcnYOUR_BOT_TOKEN> 替换为您的 Bot Token，并将 https://yourdomain.com/path/to/your_bot.php 替换为您 Bot 脚本的实际 URL。

2. 接收与解析更新数据

当 Telegram 将更新发送到您的 Webhook URL 时，数据会通过 HTTP POST 请求的请求体发送。在 PHP 中，您可以使用 file_get_contents('php://input') 来获取这些原始数据，然后使用 json_decode 解析为 PHP 数组。

立即学习“PHP免费学习笔记（深入）”；

<?php

// 替换为您的 Bot Token
$botToken = "YOUR_BOT_TOKEN";
$botAPI = "https://api.telegram.org/bot" . $botToken;

// 获取 Telegram 发送的更新数据
$update = json_decode(file_get_contents('php://input'), true);

// 调试用途：将更新数据写入日志文件
// file_put_contents('telegram_update_log.txt', print_r($update, true) . "\n", FILE_APPEND);

// 提取必要信息
$chatId = $update['message']['chat']['id'] ?? $update['callback_query']['message']['chat']['id'] ?? null;
$userId = $update['message']['from']['id'] ?? $update['callback_query']['from']['id'] ?? null;
$messageText = $update['message']['text'] ?? '';
$callbackQueryId = $update['callback_query']['id'] ?? null;
$callbackData = $update['callback_query']['data'] ?? '';

// 辅助函数：发送消息
function sendMessage($botAPI, $content) {
    $url = $botAPI . '/sendMessage?' . http_build_query($content);
    $response = file_get_contents($url);
    // 可以在此处添加错误处理或日志记录
    return $response;
}

// 辅助函数：回应回调查询
function answerCallbackQuery($botAPI, $callbackQueryId, $text = '', $showAlert = false) {
    $content = [
        'callback_query_id' => $callbackQueryId,
        'text' => $text,
        'show_alert' => $showAlert
    ];
    $url = $botAPI . '/answerCallbackQuery?' . http_build_query($content);
    $response = file_get_contents($url);
    return $response;
}

// ... 后续处理逻辑 ...
?>

登录后复制

在上述代码中，我们首先定义了 Bot Token 和 API URL，并创建了两个辅助函数 sendMessage 和 answerCallbackQuery，以便于后续发送消息和处理回调。$update 变量将包含所有传入的事件数据，包括消息、回调查询等。

3. 构建内联键盘与回调数据

内联键盘是直接附加在消息下方的按钮，它们不会占据用户键盘区域。每个内联按钮都可以附加一个 callback_data 字符串，当用户点击按钮时，这个数据会被发送给 Bot。

腾讯智影-AI数字人

基于AI数字人能力，实现7*24小时AI数字人直播带货，低成本实现直播业务快速增增，全天智能在线直播

查看详情

以下示例展示了如何发送一条消息，其中包含一个带有 callback_data 的内联按钮：

// ... （接上文代码）

// 1. 处理普通消息
if (isset($update['message'])) {
    if ($messageText == '/start' || $messageText == '? Submit your Detalis') {
        // 构建内联键盘按钮
        $keyboard = json_encode([
            "inline_keyboard" => [
                [
                    [
                        "text" => "✅ Done", // 按钮上显示的文本
                        "callback_data" => "checkIsMember" // 附加的回调数据
                    ]
                ]
            ]
        ]);

        $content = [
            'chat_id' => $chatId,
            'reply_markup' => $keyboard, // 将内联键盘添加到消息中
            'text' => "加入我们的 Telegram 频道\n<b>点击 \"✅ Done\" 继续</b>",
            'parse_mode' => 'HTML' // 允许使用 HTML 格式
        ];
        sendMessage($botAPI, $content);
    }
    // ... 其他普通消息处理逻辑 ...
}

// ... （接下文代码）

登录后复制

在这个例子中，当用户发送 /start 或 ? Submit your Detalis 时，Bot 会发送一条消息，并附带一个“✅ Done”按钮。当用户点击这个按钮时，Bot 将收到一个 callback_query，其中包含 callback_data 值 checkIsMember。

4. 处理回调查询

当用户点击内联按钮时，Bot 会收到一个 callback_query 类型的更新。您需要检查 $update 数组中是否存在 callback_query 键，并提取其中的 data 字段来判断用户点击了哪个按钮。

// ... （接上文代码）

// 2. 处理回调查询（当用户点击内联按钮时）
if (isset($update['callback_query'])) {
    if ($callbackData == 'checkIsMember') {
        // 当用户点击 "✅ Done" 按钮后
        $content = [
            'chat_id' => $chatId,
            'text' => "? 请在下方提交您的 Twitter 用户名 (包含 @)\n\n例如：@username"
        ];
        sendMessage($botAPI, $content);

        // 最佳实践：回应回调查询，移除按钮上的加载状态，提升用户体验
        // 可以选择显示一个短暂的通知，或者只是消除加载动画
        answerCallbackQuery($botAPI, $callbackQueryId, "请提交您的 Twitter 用户名。", false);

        // 在实际应用中，您可能需要更新用户状态，以便下一步处理用户输入的 Twitter 用户名
        // setUserState($userId, 'waiting_twitter_username');
    }
    // 可以有更多的 else if 来处理不同的 callback_data
    // else if ($callbackData == 'another_action') {
    //     // ...
    // }
}

?>

登录后复制

在此部分，当 Bot 收到 callback_data 为 checkIsMember 的回调查询时，它会向用户发送一条新消息，请求用户提交 Twitter 用户名。同时，通过调用 answerCallbackQuery，可以向用户显示一个短暂的提示，并消除按钮上的加载动画，这对于改善用户体验至关重要。

5. 完整 Bot 脚本示例

将上述所有代码片段整合，构成一个基本的 Telegram Bot 脚本：

<?php

// 替换为您的 Bot Token
$botToken = "YOUR_BOT_TOKEN";
$botAPI = "https://api.telegram.org/bot" . $botToken;

// 辅助函数：发送消息
function sendMessage($botAPI, $content) {
    $url = $botAPI . '/sendMessage?' . http_build_query($content);
    $response = file_get_contents($url);
    if ($response === FALSE) {
        error_log("Failed to send message: " . print_r($content, true));
    }
    return $response;
}

// 辅助函数：回应回调查询
function answerCallbackQuery($botAPI, $callbackQueryId, $text = '', $showAlert = false) {
    $content = [
        'callback_query_id' => $callbackQueryId,
        'text' => $text,
        'show_alert' => $showAlert
    ];
    $url = $botAPI . '/answerCallbackQuery?' . http_build_query($content);
    $response = file_get_contents($url);
    if ($response === FALSE) {
        error_log("Failed to answer callback query: " . print_r($content, true));
    }
    return $response;
}

// 获取 Telegram 发送的更新数据
$update = json_decode(file_get_contents('php://input'), true);

// 调试用途：将更新数据写入日志文件
// file_put_contents('telegram_update_log.txt', print_r($update, true) . "\n", FILE_APPEND);

// 提取必要信息
$chatId = $update['message']['chat']['id'] ?? $update['callback_query']['message']['chat']['id'] ?? null;
$userId = $update['message']['from']['id'] ?? $update['callback_query']['from']['id'] ?? null;
$messageText = $update['message']['text'] ?? '';
$callbackQueryId = $update['callback_query']['id'] ?? null;
$callbackData = $update['callback_query']['data'] ?? '';

// 1. 处理普通消息
if (isset($update['message'])) {
    if ($messageText == '/start' || $messageText == '? Submit your Detalis') {
        $keyboard = json_encode([
            "inline_keyboard" => [
                [
                    [
                        "text" => "✅ Done",
                        "callback_data" => "checkIsMember"
                    ]
                ]
            ]
        ]);

        $content = [
            'chat_id' => $chatId,
            'reply_markup' => $keyboard,
            'text' => "加入我们的 Telegram 频道\n<b>点击 \"✅ Done\" 继续</b>",
            'parse_mode' => 'HTML'
        ];
        sendMessage($botAPI, $content);
    }
    // 示例：处理用户在点击按钮后输入的 Twitter 用户名
    // 实际应用中，这里需要结合用户状态管理来判断当前用户是否在等待输入 Twitter 用户名
    // 例如，您可以使用数据库或文件存储用户的当前对话状态。
    // if (getUserState($userId) == 'waiting_twitter_username' && strpos($messageText, '@') === 0) {
    //     // 保存 Twitter 用户名到数据库
    //     // updateUserTwitterUsername($userId, $messageText);
    //     sendMessage($botAPI, ['chat_id' => $chatId, 'text' => "好的，您的 Twitter 用户名已保存：{$messageText}。现在请输入您的密码。"]);
    //     // 更新用户状态为 'waiting_password'
    //     // setUserState($userId, 'waiting_password');
    // } else if (getUserState($userId) == 'waiting_password')

登录后复制

以上就是PHP Telegram Bot：实现交互式回调数据处理的详细内容，更多请关注php中文网其它相关文章！