tbotsend (Telegram Bot Send)

tbotsend is a command-line tool written in Go for sending messages via a Telegram bot. It allows you to send messages to a specified chat ID using a bot token, with support for configuration via files or command-line flags. The tool is designed to be simple, efficient, and easily integrated into scripts or automated workflows.

Table of Contents

• Features
• Installation
• Usage
  • Command-Line Options
  • Configuration Files
  • Examples
• Building from Source
• License

Features

• Send Messages via Telegram Bot: Easily send messages to any chat ID using your Telegram bot token.
• Configuration Flexibility: Configure the tool using command-line flags or YAML configuration files.
• Silent Mode: Option to disable notifications for messages sent.
• Customizable Timeout: Set custom timeout values for network requests.
• Version Information: Quickly check the tool's version with the --version flag.

Installation

You can download the pre-built binary from the releases page or build from source by following the Building from Source section.

Usage

Command-Line Options

Option	Short	Description
--config <path>	-f	Configuration file path.
--chatid <id>	-c	Chat ID value.
--token <token>	-t	Bot token value.
--timeout <seconds>		Timeout value in seconds (default is 10).
--silent	-s	Disable notification sounds (for message receipt).
--version	-v	Print version information and exit.
--help	-h	Display help information.

• Note: You cannot use both configuration flags (--chatid, --token) and a configuration file (--config) at the same time. Choose one method to provide your configuration.

Configuration Files

tbotsend supports configuration via YAML files. By default, it looks for configuration files in the following order:

1. ${HOME}/.config/tbotsend.yaml
2. ${HOME}/.tbotsend.yaml

Configuration File Format

Create a YAML file with the following structure:

CHATID: "your_chat_id"
TOKEN: "your_bot_token"
TIMEOUT: 10

• CHATID (string): The chat ID where the message will be sent. This can be obtained from Telegram.
• TOKEN (string): The bot token provided by the BotFather.
• TIMEOUT (integer, optional): Timeout value in seconds for the HTTP POST request. Default: 10

Specifying a Custom Configuration File

Use the --config of -f flag to specify a custom configuration file:

tbotsend --config /path/to/your/config.yaml "This is a message!"

Examples

Sending a Message Using the Default Configuration File

tbotsend "Здравствуйте, Telegram!"

Sending a Message with Silent Mode Enabled

tbotsend --silent "This message will not send a notification."

tbotsend -s "Neither will this one."

tbotsend "Or even this one!" -s

Sending a Message Using Flags Instead of Conf File

tbotsend -c "123456789" -t "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11" "Message sent using flags."

Display Version Information

tbotsend -v

tbotsend --version

----TO BE CONTINUED