Метод getBusinessConnection

Метод получает информацию о подключении бота к бизнес-аккаунту Telegram.

Описание

Используйте этот метод для получения информации о подключении бота к бизнес-аккаунту. При успешном выполнении возвращает объект BusinessConnection.

Параметр Тип Обязательный Описание
business_connection_id String Да Уникальный идентификатор бизнес-подключения

Примеры

php

<?php

$botToken = 'YOUR_BOT_TOKEN';
$businessConnectionId = 'YOUR_BUSINESS_CONNECTION_ID';

$apiUrl = "https://api.telegram.org/bot{$botToken}/getBusinessConnection";

$data = [
    'business_connection_id' => $businessConnectionId
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($response === false) {
    $error = curl_error($ch);
    curl_close($ch);
    throw new Exception("cURL Error: {$error}");
}

curl_close($ch);

$result = json_decode($response, true);

if (!$result['ok']) {
    $errorDescription = $result['description'] ?? 'Unknown error';
    throw new Exception("API Error: {$errorDescription}");
}

$businessConnection = $result['result'];

echo "Business Connection ID: " . $businessConnection['id'] . PHP_EOL;
echo "User ID: " . $businessConnection['user']['id'] . PHP_EOL;
echo "User First Name: " . $businessConnection['user']['first_name'] . PHP_EOL;
echo "User Username: " . ($businessConnection['user']['username'] ?? 'N/A') . PHP_EOL;
echo "Date Connected: " . date('Y-m-d H:i:s', $businessConnection['user_connection_date']) . PHP_EOL;
echo "Can Reply: " . ($businessConnection['can_reply'] ? 'Yes' : 'No') . PHP_EOL;
echo "Is Enabled: " . ($businessConnection['is_enabled'] ? 'Yes' : 'No') . PHP_EOL;

?>

python

import requests

def get_business_connection(bot_token, business_connection_id):
    """
    Получает информацию о подключении бота к бизнес-аккаунту
    
    Args:
        bot_token (str): Токен вашего бота
        business_connection_id (str): Уникальный идентификатор бизнес-подключения
    
    Returns:
        dict: Объект BusinessConnection или информация об ошибке
    """
    url = f"https://api.telegram.org/bot{bot_token}/getBusinessConnection"
    
    payload = {
        "business_connection_id": business_connection_id
    }
    
    try:
        response = requests.post(url, json=payload)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        return {"ok": False, "error": str(e)}

# Пример использования
if __name__ == "__main__":
    # Замените на реальные значения
    BOT_TOKEN = "YOUR_BOT_TOKEN_HERE"
    BUSINESS_CONNECTION_ID = "your_business_connection_id_here"
    
    result = get_business_connection(BOT_TOKEN, BUSINESS_CONNECTION_ID)
    print(result)

История изменений

  • API 7.2. Добавлен метод getBusinessConnection

Дополнительно

  • BusinessConnection - Объект, описывающий подключение Telegram-бота к бизнес-аккаунту с информацией о пользователе, правах и статусе соединения.
Комментарии