Метод sendAudio

Описание

Примеры

php

<?php

$botToken = 'YOUR_BOT_TOKEN';
$chatId = 'TARGET_CHAT_ID';

// Вариант 1: Отправка аудио по file_id (уже загруженного на сервера Telegram)
$audioFileId = 'AgACAgIAAxkBAAIB...'; // Пример file_id

$data = [
    'chat_id' => $chatId,
    'audio' => $audioFileId,
    'caption' => 'Ваша музыкальная композиция',
    'parse_mode' => 'HTML',
    'duration' => 180,
    'performer' => 'Исполнитель',
    'title' => 'Название трека',
    'disable_notification' => false,
    'protect_content' => false
];

// Вариант 2: Отправка аудио по URL
$audioUrl = 'https://example.com/audio/song.mp3';

$dataUrl = [
    'chat_id' => $chatId,
    'audio' => $audioUrl,
    'caption' => 'Аудио из интернета',
    'parse_mode' => 'MarkdownV2'
];

// Вариант 3: Загрузка нового аудио файла (multipart/form-data)
$audioPath = '/path/to/your/audio.mp3';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.telegram.org/bot{$botToken}/sendAudio");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$postFields = [
    'chat_id' => $chatId,
    'caption' => 'Новое аудио',
    'duration' => 200,
    'performer' => 'Мой бот',
    'title' => 'Загруженный трек',
    'disable_notification' => true
];

// Добавляем файл если он существует
if (file_exists($audioPath)) {
    $postFields['audio'] = new CURLFile($audioPath);
    
    // Добавляем обложку если нужно
    $thumbnailPath = '/path/to/thumbnail.jpg';
    if (file_exists($thumbnailPath)) {
        $postFields['thumbnail'] = new CURLFile($thumbnailPath);
    }
}

curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);

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

$result = json_decode($response, true);

if ($result['ok']) {
    echo "Аудио отправлено! ID сообщения: " . $result['result']['message_id'];
} else {
    echo "Ошибка: " . $result['description'];
}

// Вариант 4: С использованием reply_markup
$dataWithKeyboard = [
    'chat_id' => $chatId,
    'audio' => $audioFileId,
    'caption' => 'Выберите действие:',
    'reply_markup' => json_encode([
        'inline_keyboard' => [
            [
                ['text' => '👍 Нравится', 'callback_data' => 'like_audio'],
                ['text' => '👎 Не нравится', 'callback_data' => 'dislike_audio']
            ],
            [
                ['text' => 'Скачать', 'url' => 'https://example.com/download']
            ]
        ]
    ])
];

// Вариант 5: С reply_parameters (ответ на сообщение)
$dataWithReply = [
    'chat_id' => $chatId,
    'audio' => $audioFileId,
    'caption' => 'В ответ на ваше сообщение',
    'reply_parameters' => json_encode([
        'message_id' => 12345,
        'chat_id' => $chatId,
        'allow_sending_without_reply' => true
    ])
];

// Функция для отправки запроса
function sendTelegramRequest($method, $data, $isMultipart = false) {
    $botToken = 'YOUR_BOT_TOKEN';
    $url = "https://api.telegram.org/bot{$botToken}/{$method}";
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    if ($isMultipart) {
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: multipart/form-data']);
    } else {
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
        $data = json_encode($data);
    }
    
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($response, true);
}

// Пример использования функции
$result = sendTelegramRequest('sendAudio', $data);
if ($result['ok']) {
    // Обработка успешной отправки
    $messageId = $result['result']['message_id'];
    // ... дальнейшие действия
}

?>

python

import requests

def send_audio(bot_token, chat_id, audio_file_path, caption=None, duration=None, performer=None, title=None):
    """
    Отправляет аудиофайл в указанный чат.
    
    :param bot_token: Токен вашего бота
    :param chat_id: ID чата или username канала
    :param audio_file_path: Путь к аудиофайлу (.mp3 или .m4a)
    :param caption: Подпись к аудио (до 1024 символов)
    :param duration: Длительность аудио в секундах
    :param performer: Исполнитель
    :param title: Название трека
    :return: Ответ от Telegram API
    """
    url = f"https://api.telegram.org/bot{bot_token}/sendAudio"
    
    # Подготовка данных
    data = {
        'chat_id': chat_id,
    }
    
    if caption:
        data['caption'] = caption
    if duration:
        data['duration'] = duration
    if performer:
        data['performer'] = performer
    if title:
        data['title'] = title
    
    # Открытие файла для отправки
    with open(audio_file_path, 'rb') as audio_file:
        files = {
            'audio': audio_file
        }
        
        # Отправка запроса
        response = requests.post(url, data=data, files=files)
    
    return response.json()

# Пример использования
if __name__ == "__main__":
    # Конфигурация
    BOT_TOKEN = "YOUR_BOT_TOKEN"
    CHAT_ID = "123456789"  # или "@channelusername"
    AUDIO_FILE = "music.mp3"
    
    # Отправка аудио с подписью
    result = send_audio(
        bot_token=BOT_TOKEN,
        chat_id=CHAT_ID,
        audio_file_path=AUDIO_FILE,
        caption="Отличная музыка! 🎵",
        duration=180,
        performer="Исполнитель",
        title="Название трека"
    )
    
    print(result)

# Альтернативный пример с использованием file_id
def send_audio_by_file_id(bot_token, chat_id, file_id, caption=None):
    """
    Отправляет аудио по file_id (файл уже загружен на серверах Telegram)
    """
    url = f"https://api.telegram.org/bot{bot_token}/sendAudio"
    
    payload = {
        'chat_id': chat_id,
        'audio': file_id
    }
    
    if caption:
        payload['caption'] = caption
    
    response = requests.post(url, json=payload)
    return response.json()

# Пример с дополнительными параметрами
def send_audio_with_options(bot_token, chat_id, audio_file_path, **kwargs):
    """
    Расширенная версия с поддержкой дополнительных параметров
    """
    url = f"https://api.telegram.org/bot{bot_token}/sendAudio"
    
    # Базовые параметры
    data = {
        'chat_id': chat_id,
        'parse_mode': kwargs.get('parse_mode', 'HTML'),
        'disable_notification': kwargs.get('disable_notification', False),
        'protect_content': kwargs.get('protect_content', False)
    }
    
    # Опциональные параметры
    optional_params = ['caption', 'duration', 'performer', 'title', 
                      'message_thread_id', 'reply_parameters', 'reply_markup']
    
    for param in optional_params:
        if param in kwargs:
            data[param] = kwargs[param]
    
    # Отправка файла
    with open(audio_file_path, 'rb') as audio_file:
        files = {'audio': audio_file}
        
        # Если есть миниатюра
        if 'thumbnail' in kwargs:
            with open(kwargs['thumbnail'], 'rb') as thumb_file:
                files['thumbnail'] = thumb_file
        
        response = requests.post(url, data=data, files=files)
    
    return response.json()

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

• API 2.2.. Обновлен метод sendAudio: Добавлено поле caption
• API 5.0. Обновлен метод sendAudio: Добавлена возможность ручного указания текстовых сущностей и поле allow_sending_without_reply
• API 5.6. Обновлен метод sendAudio: Добавлено поле protect_content
• API 6.3. Обновлен метод sendAudio: Добавлен параметр message_thread_id
• API 6.6. Обновлен метод sendAudio: Переименован параметр thumb в thumbnail
• API 7.0. Обновлен метод sendAudio: Заменены параметры reply_to_message_id и allow_sending_without_reply на reply_parameters
• API 7.4. Обновлен метод sendAudio: Добавлен параметр message_effect_id
• API 7.11. Обновлен метод sendAudio: Добавлен параметр allow_paid_broadcast
• API 9.2. Обновлен метод sendAudio: Добавлен параметр direct_messages_topic_id
• API 9.3. Обновлен метод sendAudio: Поддержан параметр message_thread_id в личных чатах с темами для отправки сообщения в конкретную тему.

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

• Message - Это основной объект, представляющий сообщение в Telegram, который содержит информацию об отправителе, чате, контенте (текст, медиа, служебные данные) и различные метаданные.
• sendVoice - Метод для отправки голосовых сообщений в форматах OGG, MP3 или M4A, которые отображаются в клиентах Telegram как воспроизводимые аудиозаписи.
• InputFile - Объект, представляющий содержимое файла для загрузки через multipart/form-data.
• MessageEntity - Объект MessageEntity представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.
• SuggestedPostParameters - Объект содержит параметры публикации, предлагаемой ботом, включая цену и дату отправки.
• ReplyParameters - Объект, описывающий параметры для ответа на сообщение, включая идентификатор сообщения, чат, цитирование и дополнительные настройки.
• InlineKeyboardMarkup - Объект для создания встроенной клавиатуры, которая отображается непосредственно в сообщении.
• ReplyKeyboardMarkup - Объект, представляющий пользовательскую клавиатуру с вариантами ответа для ботов Telegram.
• ReplyKeyboardRemove - Объект для удаления пользовательской клавиатуры и возврата к стандартной буквенной клавиатуре в клиентах Telegram.
• ForceReply - Объект ForceReply принудительно отображает интерфейс ответа в клиентах Telegram, упрощая создание пошаговых диалогов с ботом.