本文档介绍了如何使用 Telegram Bot API 发送包含可点击电话号码的消息。由于`sendMessage`方法对`phone_number`实体类型的支持有限，本文将介绍使用`sendContact`方法来安全有效地实现此功能。我们将提供代码示例和详细步骤，帮助开发者在 Telegram 消息中集成可点击的电话号码。
在 Telegram 机器人开发中，有时需要发送包含电话号码的消息，并希望用户能够直接点击该号码进行拨打。虽然sendMessage方法提供了entities参数来格式化消息，但对于phone_number实体类型的支持可能并不稳定。因此，推荐使用sendContact方法来实现此功能。
使用 sendContact 方法
sendContact方法专门用于发送联系人信息，包括电话号码。这是一种更可靠且官方推荐的方式来发送可点击的电话号码。
以下是使用 PHP 和 GuzzleHttp 库的示例代码：
<?php
require 'vendor/autoload.php'; // 引入 Composer 自动加载
$apiKey = 'YOUR_BOT_API_KEY'; // 替换为你的 Bot API Key
$chatID = 'YOUR_CHAT_ID'; // 替换为你的 Chat ID
$phoneNumber = '+1234567890'; // 替换为你要发送的电话号码
$firstName = 'John'; // 替换为联系人的名字
$lastName = 'Doe'; // 替换为联系人的姓氏
$apiURL = 'https://api.telegram.org/bot' . $apiKey . '/';
$client = new \GuzzleHttp\Client(['base_uri' => $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();
echo $body;
} catch (GuzzleHttp\Exception\GuzzleException $e) {
echo "Error: " . $e->getMessage();
}
?>代码解释：
- 引入依赖： 使用 Composer 引入 GuzzleHttp 库。
- 设置参数： 替换 YOUR_BOT_API_KEY、YOUR_CHAT_ID、$phoneNumber、$firstName 和 $lastName 为你的实际值。
- 创建 GuzzleHttp 客户端： 初始化 GuzzleHttp 客户端，并设置 Telegram Bot API 的基本 URL。
-
发送 sendContact 请求： 使用 sendContact 方法，通过 multipart 方式传递参数：
- chat_id: 接收消息的用户的 Chat ID。
- phone_number: 要发送的电话号码。
- first_name: 联系人的名字。
- last_name: 联系人的姓氏。
- 处理响应： 获取并输出 API 的响应。
- 错误处理： 使用 try...catch 块捕获 GuzzleHttp 异常，并输出错误信息。
注意事项：
- 确保已经安装 GuzzleHttp 库：composer require guzzlehttp/guzzle
- phone_number 必须是有效的电话号码格式。
- first_name 是必填字段，即使没有姓氏，也需要提供一个名字。
- 请务必妥善保管你的 Bot API Key，避免泄露。
总结
虽然使用sendMessage方法的entities参数可能可以实现部分格式化效果，但对于发送可点击的电话号码，sendContact方法是更可靠和推荐的选择。 通过使用sendContact方法，您可以确保电话号码在 Telegram 消息中正确显示，并且用户可以方便地点击该号码进行拨打。 这种方法不仅提高了用户体验，也符合 Telegram Bot API 的最佳实践。
