Telegram机器人发送可点击电话号：sendContact使用教程

本文档介绍了如何使用 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();
}

?>

代码解释：

1. 引入依赖： 使用 Composer 引入 GuzzleHttp 库。
2. 设置参数： 替换 YOUR_BOT_API_KEY、YOUR_CHAT_ID、$phoneNumber、$firstName 和 $lastName 为你的实际值。
3. 创建 GuzzleHttp 客户端： 初始化 GuzzleHttp 客户端，并设置 Telegram Bot API 的基本 URL。
4. 发送 sendContact 请求： 使用 sendContact 方法，通过 multipart 方式传递参数：
   • chat_id: 接收消息的用户的 Chat ID。
   • phone_number: 要发送的电话号码。
   • first_name: 联系人的名字。
   • last_name: 联系人的姓氏。
5. 处理响应： 获取并输出 API 的响应。
6. 错误处理： 使用 try...catch 块捕获 GuzzleHttp 异常，并输出错误信息。

注意事项：

• 确保已经安装 GuzzleHttp 库：composer require guzzlehttp/guzzle
• phone_number 必须是有效的电话号码格式。
• first_name 是必填字段，即使没有姓氏，也需要提供一个名字。
• 请务必妥善保管你的 Bot API Key，避免泄露。

总结

虽然使用sendMessage方法的entities参数可能可以实现部分格式化效果，但对于发送可点击的电话号码，sendContact方法是更可靠和推荐的选择。 通过使用sendContact方法，您可以确保电话号码在 Telegram 消息中正确显示，并且用户可以方便地点击该号码进行拨打。 这种方法不仅提高了用户体验，也符合 Telegram Bot API 的最佳实践。