本文旨在解决在使用 Telegram Bot API 的 `sendMessage` 方法时，如何使消息中的电话号码具备可点击拨号功能。通过分析问题和解决方案，我们将探讨使用 `sendContact` 方法作为替代方案，实现电话号码的点击拨号效果。
在使用 Telegram Bot API 开发过程中，有时我们需要在发送的消息中包含电话号码，并希望用户可以直接点击该号码进行拨号。虽然 Telegram API 提供了 MessageEntity 对象来格式化消息内容，但并非所有实体类型都适用于 sendMessage 方法。 本文将探讨如何通过 sendContact 方法，实现电话号码的可点击拨号功能。
问题背景
开发者尝试使用 sendMessage 方法，并结合 entities 参数来将消息中的电话号码标记为 phone_number 类型，期望实现点击拨号效果。然而，这种方法并未生效。
解决方案：使用 sendContact 方法
经过分析，发现 sendMessage 方法并非支持所有 MessageEntity 类型。对于电话号码，推荐使用 sendContact 方法。sendContact 方法专门用于发送联系人信息，其中包含电话号码，Telegram 客户端会自动将其识别为可点击的拨号链接。
实现步骤
构建请求参数： 使用 sendContact 方法需要提供 phone_number 和 first_name 参数。 last_name 是可选参数。chat_id 参数指定接收消息的聊天 ID。
发送请求： 使用 HTTP 客户端（例如 GuzzleHttp）向 Telegram Bot API 发送 POST 请求。
示例代码 (PHP 使用 GuzzleHttp):
<?php
require 'vendor/autoload.php'; // 引入 Composer 自动加载
$apiKey = 'YOUR_BOT_API_KEY'; // 替换为你的 Bot API Key
$chatID = 'YOUR_CHAT_ID'; // 替换为目标 Chat ID
$phoneNumber = '89991234567'; // 要发送的电话号码
$firstName = 'John'; // 联系人名字
$lastName = 'Doe'; // 联系人姓氏 (可选)
$apiURL = 'https://api.telegram.org/bot' . $apiKey . '/';
$client = new \GuzzleHttp\Client(['base_uri' => $apiURL]);
try {
$response = $client->post('sendContact', [
'form_params' => [
'chat_id' => $chatID,
'phone_number' => $phoneNumber,
'first_name' => $firstName,
'last_name' => $lastName, // Optional
],
]);
$body = $response->getBody();
$content = $body->getContents();
$data = json_decode($content, true);
if ($data['ok']) {
echo "Contact sent successfully!\n";
} else {
echo "Error sending contact: " . $data['description'] . "\n";
}
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
echo "Guzzle HTTP error: " . $e->getMessage() . "\n";
}代码解释：
- require 'vendor/autoload.php';: 引入 Composer 自动加载器，确保 GuzzleHttp 客户端可用。
- $apiKey, $chatID, $phoneNumber, $firstName, $lastName: 替换为你的实际值。
- $client = new \GuzzleHttp\Client(['base_uri' => $apiURL]);: 创建一个 GuzzleHttp 客户端，并设置 Telegram Bot API 的基本 URL。
- $client->post('sendContact', ...): 发送 POST 请求到 sendContact 方法。
- 'form_params' => [...]: 使用 form_params 传递参数，这是 GuzzleHttp 发送表单数据的推荐方式。
- try...catch: 使用 try...catch 块来捕获可能发生的 HTTP 异常。
- $data = json_decode($content, true);: 将响应的 JSON 数据解码为 PHP 数组。
- 检查 $data['ok'] 来确定请求是否成功。
注意事项：
- 确保已经安装 GuzzleHttp 客户端。可以使用 Composer 安装：composer require guzzlehttp/guzzle
- 替换代码中的 YOUR_BOT_API_KEY 和 YOUR_CHAT_ID 为你的实际值。
- phone_number 必须是有效的电话号码格式。
- first_name 是必填参数。
总结
虽然 sendMessage 方法的 entities 参数可以用于格式化消息，但对于电话号码的可点击效果，推荐使用 sendContact 方法。 通过 sendContact 方法，你可以轻松地将电话号码作为联系人信息发送给用户，Telegram 客户端会自动将其识别为可点击的拨号链接，从而提升用户体验。 在实际应用中，请根据具体需求选择合适的方法。 如果只需要发送电话号码，sendContact 是最佳选择。 如果需要在复杂的消息上下文中包含电话号码，可能需要考虑其他方案，例如自定义键盘或链接。
