Sign in

v1

latestOpenAPI 3.0.32026-07-1416059.6 KB

sendAudio

Use this method to send audio files, if you want Telegram clients to display them in the music player.

post/bot{token}/sendAudio

Path parameters

tokenstring required

Your Bot Token

Request body

chat_idstring

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

audiostring

Audio file to send. You can either pass a file_id as String to resend an audio that is already on the Telegram servers, or upload a new audio file by just passing the path to audio file as String and the SDK will take care of uploading the file for you.

durationinteger

Duration of the audio in seconds

performerstring

Performer

trackstring

Track name

disable_notificationboolean

Sends the message silently. iOS users will not receive a notification, Android users will receive a notification with no sound. Other apps coming soon.

reply_to_message_idinteger

If the message is a reply, ID of the original message

reply_markupobject

Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to hide keyboard or to force a reply from the user.

Response

200

okboolean

Example response

{
  "ok": true,
  "result": {
    "message_id": 1,
    "from": {
      "id": 12345678,
      "first_name": "YourBot",
      "username": "YourBot"
    },
    "chat": {
      "id": 123456789,
      "first_name": "John",
      "last_name": "Doe",
      "username": "JohnDoe",
      "type": "private"
    },
    "date": 1459976718,
    "audio": {
      "file_id": "aBc124XyZ...",
      "duration": 154,
      "mime_type": "audio/mpeg",
      "title": "My Audio File",
      "performer": "John Doe",
      "file_size": 2521100
    }
  }
}