EA2CW: changed set/msg_sysop by msg_sysop

2025-04-10T00:58:53Z

changed set/msg_sysop by msg_sysop

← Older revision		Revision as of 00:58, 10 April 2025
Line 26:		Line 26:
	=== Examples ===		=== Examples ===
	<pre>		<pre>
	~~set/~~msg_sysop XX0ABC REGISTER xx0abc@example.com Requesting registration		msg_sysop XX0ABC REGISTER xx0abc@example.com Requesting registration
	~~set/~~msg_sysop XX0ABC PROBLEM xx0abc@example.com My password is not working		msg_sysop XX0ABC PROBLEM xx0abc@example.com My password is not working
	~~set/~~msg_sysop XX0ABC-1 INFO xx0abc@example.com Greetings from DM42		msg_sysop XX0ABC-1 INFO xx0abc@example.com Greetings from DM42
	</pre>The user will receive a confirmation, and the sysop will receive the complete message via Telegram.		</pre>The user will receive a confirmation, and the sysop will receive the complete message via Telegram.

EA3CV at 16:07, 9 April 2025

2025-04-09T16:07:06Z

← Older revision		Revision as of 16:07, 9 April 2025
Line 79:		Line 79:
	Save it as:<pre>		Save it as:<pre>
	/spider/local_cmd/msg_sysop.pl		/spider/local_cmd/msg_sysop.pl
	</pre>It may be helpful to look at ~~<nowiki>~~[https://wiki.dxcluster.org/wiki/Setting_up_the_EA3CV_contributions_repository]~~</nowiki>~~		</pre>It may be helpful to look at [https://wiki.dxcluster.org/wiki/Setting_up_the_EA3CV_contributions_repository]

	== 🔐 How to get your Telegram ID and Token ==		== 🔐 How to get your Telegram ID and Token ==

EA3CV at 16:05, 9 April 2025

2025-04-09T16:05:28Z

← Older revision		Revision as of 16:05, 9 April 2025
Line 79:		Line 79:
	Save it as:<pre>		Save it as:<pre>
	/spider/local_cmd/msg_sysop.pl		/spider/local_cmd/msg_sysop.pl
	</pre><~~pre~~>		</pre>It may be helpful to look at <nowiki>[https://wiki.dxcluster.org/wiki/Setting_up_the_EA3CV_contributions_repository]</nowiki>


	</~~pre~~>

	== 🔐 How to get your Telegram ID and Token ==		== 🔐 How to get your Telegram ID and Token ==

EA3CV: Created page with " = 📡 Sending messages to the sysop via Telegram = == 📋 Description == The `msg_sysop` command allows users connected to a DXSpider node to send a direct message to the sysop via Telegram. It is useful for: * Requesting registration on the node * Reporting issues or failures * Making general enquiries The message includes the following data: * User callsign * Subject (e.g. REGISTER, PROBLEM, INFO) * Email address * Message text * Access IP == ▶️ Command us..."

2025-04-09T15:57:13Z

Created page with " = 📡 Sending messages to the sysop via Telegram = == 📋 Description == The `msg_sysop` command allows users connected to a DXSpider node to send a direct message to the sysop via Telegram. It is useful for: * Requesting registration on the node * Reporting issues or failures * Making general enquiries The message includes the following data: * User callsign * Subject (e.g. REGISTER, PROBLEM, INFO) * Email address * Message text * Access IP == ▶️ Command us..."

New page

= 📡 Sending messages to the sysop via Telegram =

== 📋 Description ==
The `msg_sysop` command allows users connected to a DXSpider node to send a direct message to the sysop via Telegram.

It is useful for:

* Requesting registration on the node
* Reporting issues or failures
* Making general enquiries

The message includes the following data:

* User callsign
* Subject (e.g. REGISTER, PROBLEM, INFO)
* Email address
* Message text
* Access IP

== ▶️ Command usage ==
From the DXSpider shell:<pre>
msg_sysop <CALL> <SUBJECT> <EMAIL> <MESSAGE>
</pre>

=== Examples ===
<pre>
set/msg_sysop XX0ABC REGISTER xx0abc@example.com Requesting registration
set/msg_sysop XX0ABC PROBLEM xx0abc@example.com My password is not working
set/msg_sysop XX0ABC-1 INFO xx0abc@example.com Greetings from DM42
</pre>The user will receive a confirmation, and the sysop will receive the complete message via Telegram.

== ⚙️ Required configuration ==
To use the `msg_sysop` command, minimal setup is needed for the Telegram bot.

=== 📁 File: /spider/local/Local.pm ===
Add the following to the end of the file, just before the final `1;`:<pre>
sub telegram
{
my $payload = shift;

my $url = "https://api.telegram.org/bot$main::token/sendMessage";
`curl -s -X POST $url -d chat_id=$main::id -d text="$payload\n" -d parse_mode="Markdown"`;
}
</pre>If `/spider/local/Local.pm` does not exist, you can copy it from the base installation:<pre>
cp /spider/perl/Local.pm /spider/local/
</pre>

=== 📁 File: /spider/local/DXVars.pm ===
Add your bot credentials at the end of the file, just before `1;`:<pre>
# Telegram Bot
$id = "123456789";
$token = "89734237899:KF90V20M90MCQJA9Q0'91C,CCC'0944";
</pre>Restart the node to apply the changes:<pre>
shutdown
</pre>

== 💬 Notify unregistered users ==
To let users know that they need to register and can use the `msg_sysop` command, you can override the default DXSpider error message.

Edit `/spider/startup` and add the following lines:<pre>
set/var $DXM::msgs{en}{e28} = 'Sorry, you need to be registered (Use the msg_sysop command to request registration.)'
set/var $DXM::msgs{es}{e28} = 'Lo sentimos, necesitas estar registrado (Usa el comando msg_sysop para solicitar registrarte)'
</pre>

== 📢 Display a message in the MOTD ==
To remind users upon login, edit the file `/spider/local_data/motd_nor`:<pre>
+-----------------------------------------------------------------------------+
| If you wish to have full access, please use the command 'msg_sysop' |
| to request registration on this node. |
+-----------------------------------------------------------------------------+
</pre>

== 📦 Script download ==
You can download the `msg_sysop.pl` script from the official repository:

[https://github.com/EA3CV/dxspider_info/blob/main/msg_sysop.pl View on GitHub - EA3CV/dxspider_info]

Save it as:<pre>
/spider/local_cmd/msg_sysop.pl
</pre><pre>

</pre>

== 🔐 How to get your Telegram ID and Token ==
To receive messages, you need to configure a Telegram bot:

# Open Telegram and search for <code>@BotFather</code>
# Start a new bot with: <code>/newbot</code> and follow the instructions
# BotFather will return a token like:
<pre>
1234567890:AAEjg0EjEMPLO_T0KEN4PRUEBA1234
</pre>

# Send any message to your bot via Telegram
# Then open this URL in your browser (replace with your actual token):
<pre>
https://api.telegram.org/bot<your_token>/getUpdates
</pre>You will see something like:<pre>
"chat":{"id":123456789,"first_name":"YourName",...}
</pre>That number is your **chat ID**. Use this ID and your token in `/spider/local/DXVars.pm`.

=== ⚠️ Important ===
This script **only works with Telegram bots**. It is not possible to send messages directly to personal accounts via the Telegram API.

== 🧠 Additional notes ==

* This command is designed as a lightweight and direct alternative to email.
* The sysop receives all relevant data, including the user’s IP and callsign.
* You may combine this with logging or other scripts for additional traceability.

== 🧑‍💻 Author ==

* Kin EA3CV* — [mailto:ea3cv@cronux.net](mailto:ea3cv@cronux.net)

Sending messages to the sysop via Telegram - Revision history

EA2CW: changed set/msg_sysop by msg_sysop

EA3CV at 16:07, 9 April 2025

EA3CV at 16:05, 9 April 2025