Telegram机器人中发送可点击电话号码的正确方法-php教程-PHP中文网

Telegram机器人中发送可点击电话号码的正确方法

霞舞

发布： 2025-10-29 09:52:09

原创

1000人浏览过

Telegram机器人中发送可点击电话号码的正确方法

本文旨在解决telegram机器人发送可点击电话号码的难题。通过分析`sendmessage`方法在处理`phone_number`实体时的局限性，我们揭示了其无法使电话号码可点击的原因。教程将详细介绍并演示如何利用telegram bot api提供的`sendcontact`方法，以一种简单高效的方式实现这一功能，确保用户能够轻松点击并拨打或保存联系方式。

在Telegram机器人开发中，我们经常需要向用户发送包含电话号码的信息。理想情况下，这些电话号码应该是可点击的，方便用户直接拨打或添加到联系人。然而，许多开发者在尝试使用sendMessage方法配合MessageEntity中的phone_number类型时，会发现电话号码并不能如预期般变为可点击的链接。本文将深入探讨这一问题，并提供一个正确且有效的解决方案。

1. 理解sendMessage与phone_number实体的局限性

Telegram Bot API提供了sendMessage方法，它是发送普通文本消息的核心接口。该方法支持通过entities参数来指定消息中的各种实体类型，例如text_link（文本链接）、bold（粗体）、pre（预格式化代码块）等，以实现文本的丰富格式化。

开发者可能自然地认为，使用phone_number实体类型可以使消息中的电话号码变得可点击。例如，以下代码片段展示了这种尝试：

<?php

use GuzzleHttp\Client;

$apiKey = 'YOUR_BOT_TOKEN'; // 替换为你的Bot Token
$chatID = 'YOUR_CHAT_ID';   // 替换为接收消息的聊天ID

$apiURL = 'https://api.telegram.org/bot' . $apiKey . '/';
$client = new Client(['base_uri' => $apiURL]);

try {
    $response = $client->post('sendMessage',
        [
            'multipart' => [
                [
                    'name' => 'chat_id',
                    'contents' => $chatID
                ],
                [
                    'name' => 'text',
                    'contents' => '8-999-123-45-67', // 电话号码文本
                ],
                [
                    'name' => 'entities',
                    'contents' => json_encode([
                        ['type' => 'phone_number', 'length' => 15, 'offset' => 0]
                    ]),
                ],
            ]
        ]
    );

    $body = json_decode($response->getBody()->getContents(), true);
    if ($body['ok']) {
        echo "消息发送成功，但电话号码可能不可点击。\n";
    } else {
        echo "发送失败: " . $body['description'] . "\n";
    }
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "请求出错: " . $e->getMessage() . "\n";
}

?>

登录后复制

尽管text_link和pre等实体类型在sendMessage中工作正常，但phone_number实体在此场景下通常不会使电话号码真正可点击。这是因为Telegram Bot API的设计哲学中，sendMessage主要用于发送纯文本或富文本消息，而并非所有实体类型都旨在提供深度的交互功能。对于电话号码，Telegram更倾向于通过专门的方法来处理其交互性。

2. sendContact方法：实现可点击电话号码的正确途径

要发送一个可点击的电话号码，并允许用户直接拨打或添加到联系人，我们应该使用Telegram Bot API提供的sendContact方法。此方法专为发送联系人卡片而设计，它能够确保电话号码以交互式元素呈现，提供最佳的用户体验。

sendContact方法的核心在于它发送的是一个标准的VCF（vCard）格式的联系人信息，Telegram客户端会识别并将其渲染为可交互的联系人卡片，其中包含可点击的电话号码。

Giiso写作机器人

Giiso写作机器人，让写作更简单

查看详情

3. sendContact方法的实现细节与示例

sendContact方法接受以下主要参数：

chat_id (必需): 接收联系人卡片的聊天ID或用户名。
phone_number (必需): 要发送的电话号码。请确保号码格式正确，通常建议使用国际标准格式（例如，包含国家代码）。
first_name (必需): 联系人的名字。
last_name (可选): 联系人的姓氏。
vcard (可选): 包含联系人完整vCard信息的字符串。如果提供，phone_number、first_name和last_name将被忽略。
disable_notification (可选): 布尔值，如果为true，则用户接收消息时不会收到通知。
reply_to_message_id (可选): 如果消息是对另一条消息的回复，则为原消息的ID。
allow_sending_without_reply (可选): 布尔值，如果为true，则在reply_to_message_id无效时仍发送消息。
reply_markup (可选): JSON对象，用于自定义键盘。

下面是一个使用GuzzleHttp库通过sendContact方法发送可点击电话号码的PHP示例：

<?php

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$apiKey = 'YOUR_BOT_TOKEN'; // 替换为你的Bot Token
$chatID = 'YOUR_CHAT_ID';   // 替换为接收消息的聊天ID

$apiURL = 'https://api.telegram.org/bot' . $apiKey . '/';
$client = new Client(['base_uri' => $apiURL]);

// 要发送的电话号码和联系人信息
$phoneNumber = '+1234567890'; // 建议使用国际格式，例如 +国家代码 电话号码
$firstName = '示例';
$lastName = '联系人'; // 姓氏是可选的，如果不需要可以省略

try {
    $response = $client->post('sendContact',
        [
            'json' => [ // 使用json参数发送JSON格式的数据
                'chat_id' => $chatID,
                'phone_number' => $phoneNumber,
                'first_name' => $firstName,
                'last_name' => $lastName,
            ]
        ]
    );

    $body = json_decode($response->getBody()->getContents(), true);
    if ($body['ok']) {
        echo "联系人信息（含可点击电话号码）发送成功！\n";
    } else {
        echo "发送失败: " . $body['description'] . "\n";
    }
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "请求出错: " . $e->getMessage() . "\n";
}

?>

登录后复制

注意事项：

phone_number参数应包含完整的电话号码，建议包含国家代码前缀（例如+1234567890）以确保在全球范围内的正确识别和拨打。
first_name参数是必需的，即使您只想发送一个电话号码，也需要提供一个名字。
sendContact发送的是一个联系人卡片，而不是简单的文本消息。在Telegram客户端中，它会显示为一个带有联系人姓名和电话号码的独立卡片，用户可以点击电话号码直接拨打或将其添加到手机通讯录。

4. 总结

在Telegram机器人开发中，实现可点击电话号码的关键在于选择正确的API方法。尽管sendMessage方法在处理多种文本实体方面表现出色，但对于电话号码的交互性，sendContact方法才是专门且有效的解决方案。通过利用sendContact发送联系人卡片，开发者可以确保用户获得最佳的体验，方便快捷地与电话号码进行互动。始终建议查阅Telegram Bot API的官方文档，以获取最新、最准确的方法使用指南和最佳实践。

以上就是Telegram机器人中发送可点击电话号码的正确方法的详细内容，更多请关注php中文网其它相关文章！