Sign in

v1

latestOpenAPI 3.0.32026-07-1416059.6 KB

sendVoice

Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message.

post/bot{token}/sendVoice

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)

voicestring

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

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": 1459976225,
    "voice": {
      "file_id": "Abc123XyZ....",
      "duration": 5,
      "mime_type": "audio/ogg",
      "file_size": 35015
    }
  }
}