本文介绍了如何通过 Telegram Bot API 的 `sendContact` 方法，在消息中创建可点击的电话号码链接。重点讲解了使用 `sendMessage` 方法设置 `phone_number` 实体失败的原因，并提供了使用 `sendContact` 方法的解决方案，以及该方法的具体使用示例和注意事项。
在 Telegram Bot 开发中，有时我们需要在消息中包含电话号码，并希望用户能够直接点击该号码进行拨号。虽然 Telegram Bot API 的 sendMessage 方法支持使用 entities 字段来格式化消息，但并非所有类型的实体都受支持。phone_number 实体就是一个例外。
为什么 sendMessage 方法的 phone_number 实体不起作用？
根据 Telegram Bot API 的文档和实践经验，sendMessage 方法虽然支持多种实体类型（如 text_link 和 pre），但对 phone_number 实体类型的支持并不完整或已弃用。因此，尝试通过 sendMessage 方法设置 phone_number 实体，通常不会达到预期的效果。
解决方案：使用 sendContact 方法
要实现可点击的电话号码，推荐使用 Telegram Bot API 提供的 sendContact 方法。该方法专门用于发送联系人信息，包括电话号码。
sendContact 方法的使用示例：
以下是一个使用 GuzzleHttp 客户端发送联系人信息的示例代码：
$apiURL]);
try {
$response = $client->post('sendContact', [
'multipart' => [
[
'name' => 'chat_id',
'contents' => $chatID
],
[
'name' => 'phone_number',
'contents' => $phoneNumber
],
[
'name' => 'first_name',
'contents' => $firstName
],
[
'name' => 'last_name',
'contents' => $lastName
],
]
]);
// 处理响应
$body = $response->getBody();
$data = json_decode($body, true);
if ($data['ok']) {
echo "联系人信息发送成功！\n";
} else {
echo "联系人信息发送失败： " . $data['description'] . "\n";
}
} catch (\Exception $e) {
echo "发生错误： " . $e->getMessage() . "\n";
}
?>代码解释：
- 引入 GuzzleHttp 客户端： 首先，确保你的项目中已经安装了 GuzzleHttp 客户端。
- 设置 API 密钥和 Chat ID： 将 YOUR_BOT_API_KEY 替换为你的 Telegram Bot API 密钥，YOUR_CHAT_ID 替换为目标聊天 ID。
- 定义联系人信息： 设置电话号码 (phone_number)，必须使用国际格式（例如：+15551234567）。 还可以设置联系人的名字 (first_name) 和姓氏 (last_name)，这些是可选的。
- 构建请求： 使用 multipart 格式构建 POST 请求，包含 chat_id、phone_number、first_name 和 last_name 字段。
- 发送请求： 使用 GuzzleHttp 客户端发送 sendContact 请求。
- 处理响应： 解析响应，检查 ok 字段是否为 true。如果发送成功，输出成功消息；否则，输出错误信息。
- 错误处理： 使用 try-catch 块捕获可能发生的异常，并输出错误信息。
注意事项：
- 电话号码格式： phone_number 字段必须使用国际格式，以 + 开头，后跟国家代码和电话号码。
- 权限： 确保你的 Bot 具有向目标聊天发送消息的权限。
- 错误处理： 始终进行错误处理，以便在发送失败时能够及时发现问题。
- 其他参数： sendContact 方法还支持其他可选参数，例如 vcard，用于发送完整的 vCard 格式的联系人信息。
总结：
虽然 sendMessage 方法的 phone_number 实体可能无法正常工作，但通过使用 sendContact 方法，你可以轻松地在 Telegram 消息中创建可点击的电话号码链接。 记住使用国际格式的电话号码，并进行适当的错误处理，以确保消息发送成功。 这种方法为用户提供了更便捷的交互体验，提升了 Telegram Bot 的实用性。
