telekit send "The report is ready." --yes
telekit send "…" --file ./chart.png --yes
telekit send --file ./clip.mp4 --yes
telekit send "…" --profile alerts --yes
Never send without --yes. Without it, telekit prints the destination, the text, and each file (path, sniffed type, size, API method) and does not call Telegram.

​
Files

--file is repeatable. Files go out in order, after the text (or as a caption when there is exactly one file that fits). --as-document forces a byte-exact document even for images.

​
Who receives it

Default: the default owner on the default bot. Non-default profiles need --user <id> or --owner when that profile has one unambiguous owner grant. --profile <slug> selects the bot. Beats and crons should use the alerts profile, not the chat bot.

​
Agents

Do not add --yes unless the human asked you to message them, or a standing instruction covers it. Preview first.