Метод setBusinessAccountBio

Изменяет описание бизнес-аккаунта при наличии соответствующих прав бота.

Описание

Изменяет био управляемого бизнес-аккаунта. Требует права бизнес-бота can_change_bio. Возвращает True при успехе.

Параметр Тип Обязательный Описание
business_connection_id String Да Уникальный идентификатор бизнес-подключения
bio String Опционально Новое значение био для бизнес-аккаунта; 0-140 символов

Примеры

php

<?php

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

// Параметры метода
$params = [
    'business_connection_id' => '1234567890', // Замените на реальный ID бизнес-соединения
    'bio' => 'Новое био бизнес-аккаунта до 140 символов' // Новый текст био (опционально)
];

// Отправка запроса
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl . 'setBusinessAccountBio');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // Отключить для локального тестирования

$response = curl_exec($ch);
curl_close($ch);

// Обработка ответа
$result = json_decode($response, true);

if ($result['ok']) {
    echo "Био успешно обновлено!";
} else {
    echo "Ошибка: " . $result['description'];
}

// Альтернативный вариант с использованием file_get_contents
/*
$context = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query($params)
    ]
]);

$response = file_get_contents($apiUrl . 'setBusinessAccountBio', false, $context);
$result = json_decode($response, true);
*/
?>

python

import requests

def set_business_account_bio(bot_token, business_connection_id, bio=None):
    """
    Изменяет био управляемого бизнес-аккаунта.
    
    Args:
        bot_token (str): Токен вашего бота
        business_connection_id (str): Уникальный идентификатор бизнес-подключения
        bio (str, optional): Новое значение био (0-140 символов). По умолчанию None.
    
    Returns:
        bool: True в случае успеха, иначе False
    """
    url = f"https://api.telegram.org/bot{bot_token}/setBusinessAccountBio"
    
    payload = {
        "business_connection_id": business_connection_id
    }
    
    if bio is not None:
        payload["bio"] = bio
    
    try:
        response = requests.post(url, json=payload)
        response.raise_for_status()
        result = response.json()
        
        if result.get("ok"):
            return True
        else:
            print(f"Ошибка: {result.get('description')}")
            return False
            
    except requests.exceptions.RequestException as e:
        print(f"Ошибка запроса: {e}")
        return False

# Пример использования
if __name__ == "__main__":
    # Замените на ваш токен бота
    BOT_TOKEN = "YOUR_BOT_TOKEN_HERE"
    
    # Замените на реальный ID бизнес-подключения
    BUSINESS_CONNECTION_ID = "your_business_connection_id_here"
    
    # Пример 1: Установка нового био
    new_bio = "Добро пожаловать в наш бизнес! Работаем с 9:00 до 18:00."
    success = set_business_account_bio(BOT_TOKEN, BUSINESS_CONNECTION_ID, new_bio)
    
    if success:
        print("Био успешно обновлено!")
    else:
        print("Не удалось обновить био")
    
    # Пример 2: Очистка био (передача пустой строки)
    success = set_business_account_bio(BOT_TOKEN, BUSINESS_CONNECTION_ID, "")
    
    if success:
        print("Био успешно очищено!")
    else:
        print("Не удалось очистить био")

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

  • API 9.0. Добавлен метод setBusinessAccountBio
Комментарии