send_chat_action()
- Client.send_chat_action()
Tell the other party that something is happening on your side.
- Parameters
chat_id (
int|str) – Unique identifier (int) or username (str) of the target chat. For your personal cloud (Saved Messages) you can simply use “me” or “self”. For a contact that exists in your Telegram address book you can use his phone number (str).action (
str) – Type of action to broadcast. Choose one, depending on what the user is about to receive: “typing” for text messages, “upload_photo” for photos, “record_video” or “upload_video” for videos, “record_audio” or “upload_audio” for audio files, “upload_document” for general files, “find_location” for location data, “record_video_note” or “upload_video_note” for video notes, “choose_contact” for contacts, “playing” for games, “speaking” for speaking in group calls or “import_history” for importing history, “choose_sticker” for stickers or “cancel” to cancel any chat action currently displayed.
- Returns
bool– On success, True is returned.- Raises
ValueError – In case the provided string is not a valid chat action.
Example
# Send "typing" chat action app.send_chat_action(chat_id, "typing") # Send "upload_video" chat action app.send_chat_action(chat_id, "upload_video") # Send "playing" chat action app.send_chat_action(chat_id, "playing") # Cancel any current chat action app.send_chat_action(chat_id, "cancel")