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。
以下示例展示了如何发送一条消息，其中包含一个带有 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') 
