configure(conf, channel=False, group=False, fm_integration=False)

Guide user to set up the bot, saves configuration at conf.


  • conf (str): Path where to save the configuration file. May contain ~ for user's home.
  • channel (Optional[bool]): Configure a channel.
  • group (Optional[bool]): Configure a group.
  • fm_integration (Optional[bool]): Setup file manager integration.


send(*, messages=None, files=None, images=None, stickers=None, animations=None, videos=None, audios=None, captions=None, locations=None, conf=None, parse_mode=None, silent=False, disable_web_page_preview=False, timeout=30)

Send data over Telegram. All arguments are optional.

Always use this function with explicit keyword arguments. So send(messages=["Hello!"]) instead of send(["Hello!"]).

The file type is the file object returned by the open() function. To send an image/file you open it in binary mode:

import telegram_send

with open("image.jpg", "rb") as f:


  • conf (str): Path of configuration file to use. Will use the default config if not specified. ~ expands to user's home directory.
  • messages (List[str]): The messages to send.
  • parse_mode (str): Specifies formatting of messages, one of ["text", "markdown", "html"].
  • files (List[file]): The files to send.
  • images (List[file]): The images to send.
  • stickers (List[file]): The stickers to send.
  • animations (List[file]): The animations to send.
  • videos (List[file]): The videos to send.
  • audios (List[file]): The audios to send.
  • captions (List[str]): The captions to send with the images/files/animations/videos or audios.
  • locations (List[str]): The locations to send. Locations are strings containing the latitude and longitude separated by whitespace or a comma.
  • silent (bool): Send silently without sound.
  • disable_web_page_preview (bool): Disables web page previews for all links in the messages.
  • timeout (int|float): The read timeout for network connections in seconds.