本教程旨在指导开发者如何使用 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/setWebhook?url=https://yourdomain.com/path/to/your_bot.php
请将 替换为您的 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免费学习笔记（深入）”；
$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。
以下示例展示了如何发送一条消息，其中包含一个带有 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点击 "✅ Done" 继续", '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 用户名 (包含 @)nn例如：@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 脚本：
$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点击 "✅ Done" 继续", '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中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1321845.html
微信扫一扫 
支付宝扫一扫 
