Telegram 中如何添加可点击电话链接

本文介绍了如何通过 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";
}

?>

代码解释：

1. 引入 GuzzleHttp 客户端： 首先，确保你的项目中已经安装了 GuzzleHttp 客户端。
2. 设置 API 密钥和 Chat ID： 将 YOUR_BOT_API_KEY 替换为你的 Telegram Bot API 密钥，YOUR_CHAT_ID 替换为目标聊天 ID。
3. 定义联系人信息： 设置电话号码 (phone_number)，必须使用国际格式（例如：+15551234567）。 还可以设置联系人的名字 (first_name) 和姓氏 (last_name)，这些是可选的。
4. 构建请求： 使用 multipart 格式构建 POST 请求，包含 chat_id、phone_number、first_name 和 last_name 字段。
5. 发送请求： 使用 GuzzleHttp 客户端发送 sendContact 请求。
6. 处理响应： 解析响应，检查 ok 字段是否为 true。如果发送成功，输出成功消息；否则，输出错误信息。
7. 错误处理： 使用 try-catch 块捕获可能发生的异常，并输出错误信息。

注意事项：

• 电话号码格式： phone_number 字段必须使用国际格式，以 + 开头，后跟国家代码和电话号码。
• 权限： 确保你的 Bot 具有向目标聊天发送消息的权限。
• 错误处理： 始终进行错误处理，以便在发送失败时能够及时发现问题。
• 其他参数： sendContact 方法还支持其他可选参数，例如 vcard，用于发送完整的 vCard 格式的联系人信息。

总结：

虽然 sendMessage 方法的 phone_number 实体可能无法正常工作，但通过使用 sendContact 方法，你可以轻松地在 Telegram 消息中创建可点击的电话号码链接。 记住使用国际格式的电话号码，并进行适当的错误处理，以确保消息发送成功。 这种方法为用户提供了更便捷的交互体验，提升了 Telegram Bot 的实用性。