PHP开发Telegram机器人：内联按钮CallbackQuery捕获失败求助

1. 修正更新数据的判断逻辑 #

你当前直接判断$updates['callback_query']，但Telegram API返回的更新结构是包裹在result数组中的，每个更新项是独立对象。比如getUpdates接口的响应格式如下：

{
  "ok": true,
  "result": [
    {
      "update_id": 12345,
      "callback_query": { ... }
    }
  ]
}

需要先遍历result数组，取出具体更新项再判断：

// 假设$updates是getUpdates接口返回的响应数组
if (!empty($updates['result'])) {
    foreach ($updates['result'] as $update) {
        if (isset($update['callback_query'])) {
            $telegram->callback();
            // 记录最后处理的update_id，下次调用getUpdates时带上offset参数避免重复处理
            $lastUpdateId = $update['update_id'];
        } else {
            $telegram->start();
        }
    }
}

2. 确认Webhook/GetUpdates配置正确性 #

• 使用Webhook时：

  • 确保服务器地址可被Telegram公网访问（推荐使用443/80端口）
  • Webhook接收的是POST请求，需读取原始POST数据：

    $updates = json_decode(file_get_contents('php://input'), true);
    // 直接判断当前更新的callback_query
    if (isset($updates['callback_query'])) {
        $telegram->callback();
    } else {
        $telegram->start();
    }
    

  • 可调用getWebhookInfo接口检查Webhook状态，确认无配置错误。

• 使用GetUpdates时：

  • 调用必须携带offset参数，值为最后处理的update_id + 1，避免重复获取旧更新
  • 控制调用间隔（建议1-2秒一次），防止被API限流

3. 必须响应Telegram的CallbackQuery请求 #

捕获到callback_query后，必须调用answerCallbackQuery接口告知Telegram已处理，否则按钮会持续加载，Telegram可能重复发送请求：

// 在$telegram->callback()方法内添加响应逻辑
$callbackQueryId = $update['callback_query']['id'];
$data = http_build_query([
    'callback_query_id' => $callbackQueryId,
    // 可选：显示临时提示文本
    'text' => '已收到你的选择',
    'show_alert' => false
]);
Http::get($this->urlBot . "/answerCallbackQuery", $data);

4. 调试技巧 #

• 打印完整的$updates数据，确认是否包含callback_query字段：

  error_log(print_r($updates, true));
  

• 检查API请求日志，确认sendMessage、getUpdates或Webhook请求是否成功

内容的提问来源于stack exchange，提问作者Raydel Piloto