如何在 Telegram sendMessage 中实现电话号码点击功能

本文旨在解决在使用 Telegram Bot API 的 `sendMessage` 方法时，如何使消息中的电话号码可点击的问题。通过分析 `MessageEntity` 的使用，并结合 `sendContact` 方法，提供了一种实现电话号码点击功能的有效方案。

在使用 Telegram Bot API 开发时，一个常见的需求是让消息中的电话号码可以直接点击拨打。虽然 sendMessage 方法支持 entities 参数来格式化消息，但并非所有类型的 MessageEntity 都被支持。本文将探讨如何解决 sendMessage 中 phone_number 类型的 MessageEntity 不生效的问题，并提供一种替代方案。

问题分析

根据问题描述，开发者尝试使用 sendMessage 方法的 entities 参数来将消息中的电话号码标记为 phone_number 类型，但未能成功。这表明 sendMessage 方法可能对 phone_number 类型的 MessageEntity 支持有限或者根本不支持。

解决方案：使用 sendContact 方法

Telegram Bot API 提供了一个专门用于发送联系人的方法：sendContact。 这个方法允许你发送包含电话号码和姓名的联系人信息，用户可以直接点击电话号码进行拨打。

代码示例

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

以下是一个使用 sendContact 方法发送联系人的 PHP 代码示例（基于 GuzzleHttp）：

<?php

use GuzzleHttp\Client;

function sendContactToTelegram(string $apiKey, string $chatID, string $phoneNumber, string $firstName = '', string $lastName = ''): void
{
    $apiURL = 'https://api.telegram.org/bot' . $apiKey . '/';
    $client = new Client(['base_uri' => $apiURL]);

    try {
        $response = $client->post('sendContact', [
            'form_params' => [
                'chat_id' => $chatID,
                'phone_number' => $phoneNumber,
                'first_name' => $firstName,
                'last_name' => $lastName,
            ],
        ]);

        // 可选：处理响应
        $statusCode = $response->getStatusCode();
        $body = $response->getBody()->getContents();

        if ($statusCode == 200) {
            echo "Contact sent successfully!\n";
        } else {
            echo "Error sending contact: " . $body . "\n";
        }

    } catch (\Exception $e) {
        echo "An error occurred: " . $e->getMessage() . "\n";
    }
}

// 示例用法
$apiKey = 'YOUR_TELEGRAM_BOT_API_KEY';
$chatID = 'YOUR_CHAT_ID';
$phoneNumber = '89991234567';
$firstName = 'John';
$lastName = 'Doe';

sendContactToTelegram($apiKey, $chatID, $phoneNumber, $firstName, $lastName);

?>

代码解释

1. 引入 GuzzleHttp Client: 使用 use GuzzleHttp\Client; 引入 GuzzleHttp 客户端。
2. 定义 sendContactToTelegram 函数: 该函数接收 API 密钥、聊天 ID、电话号码、firstName和lastName作为参数。
3. 创建 GuzzleHttp Client 实例: 创建一个指向 Telegram Bot API 的 GuzzleHttp 客户端实例。
4. 发送 sendContact 请求: 使用 client-youjiankuohaophpcnpost('sendContact', ...) 发送 POST 请求到 sendContact 方法。
   • chat_id: 目标聊天 ID。
   • phone_number: 要发送的电话号码。
   • first_name (可选): 联系人的名字。
   • last_name (可选): 联系人的姓氏。
5. 处理响应: 获取响应状态码和内容，并进行错误处理。
6. 示例用法: 提供了一个示例，展示如何调用该函数。 请务必替换 YOUR_TELEGRAM_BOT_API_KEY 和 YOUR_CHAT_ID 为你的实际值。

注意事项

• 确保已经安装 GuzzleHttp： composer require guzzlehttp/guzzle
• 替换示例代码中的 YOUR_TELEGRAM_BOT_API_KEY 和 YOUR_CHAT_ID 为你的实际值。
• phone_number 参数必须是有效的电话号码格式。
• first_name 和 last_name 是可选参数，可以根据需要设置。
• 需要确保 Bot 具有向指定 chat_id 发送消息的权限。

总结

虽然 sendMessage 方法可能不支持直接将电话号码设置为可点击的链接，但通过使用 sendContact 方法，可以有效地解决这个问题。 sendContact 方法专门用于发送联系人信息，用户可以直接点击电话号码进行拨打，从而提供更好的用户体验。在实际应用中，可以根据需要灵活地组合使用 Telegram Bot API 的各种方法，以满足不同的业务需求。

以上就是如何在 Telegram sendMessage 中实现电话号码点击功能的详细内容，更多请关注php中文网其它相关文章！