Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/centminmod/telegram-send
send messages via linux command line via Telegram Bot API
https://github.com/centminmod/telegram-send
telegram telegram-bot telegram-bot-api
Last synced: 27 days ago
JSON representation
send messages via linux command line via Telegram Bot API
- Host: GitHub
- URL: https://github.com/centminmod/telegram-send
- Owner: centminmod
- Created: 2021-07-05T07:52:07.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-07-12T04:42:37.000Z (over 3 years ago)
- Last Synced: 2024-05-02T02:09:28.536Z (6 months ago)
- Topics: telegram, telegram-bot, telegram-bot-api
- Language: Shell
- Homepage:
- Size: 129 KB
- Stars: 8
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# tgsend.sh
Send or update messages or send text files to your own Telegram Bot API created using BotFather:
* https://core.telegram.org/bots#3-how-do-i-create-a-bot
* https://core.telegram.org/bots/api#sendmessage
## Telegram BotFather
# Dependencies
Requires jq json tool install:
```
apt-get -y install jq
```
or
```
yum -y install jq
```
# Usage
Create and populate `tgtoken.ini` file in same directory as tgsend.sh with the following:
```
tgtoken='YOUR_TELEGRAM_BOT_API_TOKEN'
tgchatid='YOUR_TELEGRAM_CHATID'
tgapi="https://api.telegram.org/bot$tgtoken"
```
You can find your Telegram chat id to populate variable `tgchatid` using the following command:
```
tgtoken='YOUR_TELEGRAM_BOT_API_TOKEN'
tgapi="https://api.telegram.org/bot$tgtoken
curl -4s "$tgapi/getUpdates" | jq -r '.result[].message.chat.id'
```
Available commands:
```
./tgsend.sh
Usage:
./tgsend.sh send "your message in double quotes"
./tgsend.sh sendhtml "your message in double quotes"
disable notifications:
./tgsend.sh sendq "your message in double quotes"
./tgsend.sh sendhtmlq "your message in double quotes"
update existing message with message_id:
./tgsend.sh update "your message in double quotes" message_id
./tgsend.sh updatehtml "your message in double quotes" message_id
update existing message with message_id & disable notifications:
./tgsend.sh updateq "your message in double quotes" message_id
./tgsend.sh updatehtmlq "your message in double quotes" message_id
send file
./tgsend.sh sendf filename
```
# Examples
## Send messages in plain text or HTML format
```
./tgsend.sh send "message text"
{
"from": "centmin",
"to": "George",
"date": "2021-07-05T08:13:12Z",
"message": "message text"
}
```
```
./tgsend.sh sendhtml "message html"
{
"from": "centmin",
"to": "George",
"date": "2021-07-05T08:13:20Z",
"message": "message html"
}
```
```
./tgsend.sh send "$(free -mlt)"
{
"from": "centmin",
"to": "George",
"date": "2021-07-06T00:30:14Z",
"message": "total used free shared buff/cache available\nMem: 31973 7189 2183 2229 22600 22162\nLow: 31973 29789 2183\nHigh: 0 0 0\nSwap: 2045 3 2042\nTotal: 34019 7192 4226"
}
```
## Update an existing message with message_id
```
./tgsend.sh updateq "updated message" 38
{
"from": "centmin",
"to": "George",
"date": "2021-07-08T01:05:35Z",
"message": "[msgid: 38 Updated: Thu 08-Jul-21 01:05:34 UTC] updated message"
}
```
## Send text file
```
./tgsend.sh sendf test.txt
{
"from": "centmin",
"to": "George",
"date": "2021-07-05T08:50:19Z",
"document": "test.txt",
"mime": "text/plain",
"size": 2
}
```
## Send text message with Telegram message_id added
New feature which by default is enabled is to add the message_id to the messages via option `tg_addmsgid='y'`
```
./tgsend.sh send "message v3"
{
"from": "centmin",
"to": "George",
"date": "2021-07-06T22:33:34Z",
"message": "[msgid: 37] message v3"
}
```
Sending Centmin Mod LEMP stack cminfo command for JSON formatted cpu and memory statistics
```
./tgsend.sh send "$(cminfo sar-json | jq -r '."cpu-load"[]')"
{
"from": "centmin",
"to": "George",
"date": "2021-07-08T01:16:15Z",
"message": "[msgid: 40] {\n \"cpu\": \"all\",\n \"user\": 1.21,\n \"nice\": 0,\n \"system\": 0.49,\n \"iowait\": 0.43,\n \"steal\": 0,\n \"idle\": 97.87\n}"
}
```
```
./tgsend.sh send "$(cminfo sar-json | jq -r '."memory"')"
{
"from": "centmin",
"to": "George",
"date": "2021-07-08T01:17:09Z",
"message": "[msgid: 41] {\n \"memfree\": 3111888,\n \"memused\": 29629116,\n \"memused-percent\": 90.5,\n \"buffers\": 1323936,\n \"cached\": 17754908,\n \"commit\": 25211564,\n \"commit-percent\": 72.37,\n \"active\": 13057488,\n \"inactive\": 9479208,\n \"dirty\": 84,\n \"swpfree\": 2091768,\n \"swpused\": 3328,\n \"swpused-percent\": 0.16,\n \"swpcad\": 204,\n \"swpcad-percent\": 6.13\n}"
}
```
# Cloudflare Firewall Event log message sent
My custom `cf-analytics-graphql.sh` script querying [Cloudflare Firewall GraphQL API](https://developers.cloudflare.com/analytics/graphql-api) for a sepcific IP address - `185.34.23.76` and filter only JS Challenge triggered events for past 24hrs of firewall event entries and saving JSON formatted output in file at /home`/cf-graphql-json-output/cf-graphql-ip.json` which we can send via Telegram Bot. Unfortunately, Telegram messages have a 4096 character limit, so larger messages are not supported in `tgsend.sh` yet - working on adding support to paginate longer messages to be send by multiple messages. But for purpose of this example, the JSON output is < 4096 characters.
```
./cf-analytics-graphql.sh ip-hrs 24 185.34.23.76 jschallenge
JSON log saved: /home/cf-graphql-json-output/cf-graphql-ip.json
CSV converted log saved: /home/cf-graphql-json-output/cf-graphql-ip.csv
{ "query":
"query {
viewer {
zones(filter: {zoneTag: $zoneTag}) {
firewallEventsAdaptiveGroups(
limit: $limit,
filter: $filter,
orderBy: [datetime_DESC]
) {
dimensions {
action
botScore
botScoreSrcName
source
datetime
clientIP
clientAsn
clientCountryName
edgeColoName
clientRequestHTTPProtocol
clientRequestHTTPHost
clientRequestPath
clientRequestQuery
clientRequestScheme
clientRequestHTTPMethodName
clientRefererHost
clientRefererPath
clientRefererQuery
clientRefererScheme
edgeResponseStatus
clientASNDescription
userAgent
kind
originResponseStatus
ruleId
rayName
}
}
}
}
}",
"variables": {
"zoneTag": "zoneid",
"limit": 100,
"filter": {
"clientIP": "185.34.23.76",
"action": "jschallenge",
"datetime_geq": "2021-07-11T04:25:24Z",
"datetime_leq": "2021-07-12T04:25:24Z"
}
}
}
------------------------------------------------------------------
Cloudflare Firewall (enterprise)
------------------------------------------------------------------
since: 2021-07-11T04:25:24Z
until: 2021-07-12T04:25:24Z
------------------------------------------------------------------
1 Firewall Events for Request IP: 185.34.23.76
------------------------------------------------------------------
1 185.34.23.76 503 1xHeuristics jschallenge 47895 R-LINE-AS RU DME GET HTTP/1.0 892c40e1bef548368f6b37ab2a1dcf37
------------------------------------------------------------------
1 185.34.23.76 503 1xHeuristics jschallenge 47895 R-LINE-AS RU DME GET HTTP/1.0
------------------------------------------------------------------
1 185.34.23.76 503 1xHeuristics jschallenge 47895 R-LINE-AS RU DME domain.com GET HTTP/1.0
------------------------------------------------------------------
1 185.34.23.76 503 1xHeuristics jschallenge 47895 R-LINE-AS RU DME domain.com GET HTTP/1.0 /
------------------------------------------------------------------
185.34.23.76 66d11159cf2f7b43 503 1xHeuristics jschallenge 47895 R-LINE-AS RU DME 2021-07-11T09:39:59Z domain.com GET HTTP/1.0 /
------------------------------------------------------------------
{
"results": [
{
"action": "jschallenge",
"botScore": 1,
"botScoreSrcName": "Heuristics",
"clientASNDescription": "R-LINE-AS",
"clientAsn": "47895",
"clientCountryName": "RU",
"clientIP": "185.34.23.76",
"clientRefererHost": "domain.com",
"clientRefererPath": "",
"clientRefererQuery": "",
"clientRefererScheme": "https",
"clientRequestHTTPHost": "domain.com",
"clientRequestHTTPMethodName": "GET",
"clientRequestHTTPProtocol": "HTTP/1.0",
"clientRequestPath": "/",
"clientRequestQuery": "",
"clientRequestScheme": "https",
"datetime": "2021-07-11T09:39:59Z",
"edgeColoName": "DME",
"edgeResponseStatus": 503,
"kind": "firewall",
"originResponseStatus": 0,
"rayName": "66d11159cf2f7b43",
"ruleId": "892c40e1bef548368f6b37ab2a1dcf37",
"source": "firewallrules",
"userAgent": "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3355.4 Safari/537.36"
}
]
}
```
```
./tgsend.sh send "$(cat /home/cf-graphql-json-output/cf-graphql-ip.json | jq -r)"
{
"from": "centmin",
"to": "George",
"date": "2021-07-12T04:31:49Z",
"message": "[msgid: 50] {\n \"results\": [\n {\n \"action\": \"jschallenge\",\n \"botScore\": 1,\n \"botScoreSrcName\": \"Heuristics\",\n \"clientASNDescription\": \"R-LINE-AS\",\n \"clientAsn\": \"47895\",\n \"clientCountryName\": \"RU\",\n \"clientIP\": \"185.34.23.76\",\n \"clientRefererHost\": \"domain.com\",\n \"clientRefererPath\": \"\",\n \"clientRefererQuery\": \"\",\n \"clientRefererScheme\": \"https\",\n \"clientRequestHTTPHost\": \"domain.com\",\n \"clientRequestHTTPMethodName\": \"GET\",\n \"clientRequestHTTPProtocol\": \"HTTP/1.0\",\n \"clientRequestPath\": \"/\",\n \"clientRequestQuery\": \"\",\n \"clientRequestScheme\": \"https\",\n \"datetime\": \"2021-07-11T09:39:59Z\",\n \"edgeColoName\": \"DME\",\n \"edgeResponseStatus\": 503,\n \"kind\": \"firewall\",\n \"originResponseStatus\": 0,\n \"rayName\": \"66d11159cf2f7b43\",\n \"ruleId\": \"892c40e1bef548368f6b37ab2a1dcf37\",\n \"source\": \"firewallrules\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3355.4 Safari/537.36\"\n }\n ]\n}"
}
```
