Telegram message processor - Revision history

Mchurch: /* Configuring the plugin settings */

2017-05-29T12:37:00Z

Configuring the plugin settings

← Older revision		Revision as of 12:37, 29 May 2017
Line 25:		Line 25:
	[[File:newbot.png\|center\|600px]]		[[File:newbot.png\|center\|600px]]

	Once you have given Botfather everything it needs, you will ~~gave~~ the bot token displayed in the conversation:		Once you have given Botfather everything it needs, you will have the bot token displayed in the conversation:

	[[File:bottoken.png\|center\|600px]]		[[File:bottoken.png\|center\|600px]]

Mchurch at 13:41, 26 May 2017

2017-05-26T13:41:36Z

← Older revision		Revision as of 13:41, 26 May 2017
Line 60:		Line 60:
	At this point, return to your Moodle browser window/tab:		At this point, return to your Moodle browser window/tab:

	[[File:~~savechanges~~.png\|center\|600px]]		[[File:saveprefs.png\|center\|600px]]

	Click "Save changes", and your Telegram connection should be configured. If it isn't (there could be a delay), wait a bit and open the settings dialogue again, and click "Save changes". Note, that if you do not click the save changes before logging off, you will need to start the connect process again. In any case, once you have saved, and the connection is made, you will see that the alert icon is gone, and when you look at your settings, it will give you a link to disconnect your account. Don't use that unless you don't want Telegram integrated with your Moodle account any more:		Click "Save changes", and your Telegram connection should be configured. If it isn't (there could be a delay), wait a bit and open the settings dialogue again, and click "Save changes". Note, that if you do not click the save changes before logging off, you will need to start the connect process again. In any case, once you have saved, and the connection is made, you will see that the alert icon is gone, and when you look at your settings, it will give you a link to disconnect your account. Don't use that unless you don't want Telegram integrated with your Moodle account any more:

Mchurch at 13:40, 26 May 2017

2017-05-26T13:40:34Z

← Older revision		Revision as of 13:40, 26 May 2017
Line 64:		Line 64:
	Click "Save changes", and your Telegram connection should be configured. If it isn't (there could be a delay), wait a bit and open the settings dialogue again, and click "Save changes". Note, that if you do not click the save changes before logging off, you will need to start the connect process again. In any case, once you have saved, and the connection is made, you will see that the alert icon is gone, and when you look at your settings, it will give you a link to disconnect your account. Don't use that unless you don't want Telegram integrated with your Moodle account any more:		Click "Save changes", and your Telegram connection should be configured. If it isn't (there could be a delay), wait a bit and open the settings dialogue again, and click "Save changes". Note, that if you do not click the save changes before logging off, you will need to start the connect process again. In any case, once you have saved, and the connection is made, you will see that the alert icon is gone, and when you look at your settings, it will give you a link to disconnect your account. Don't use that unless you don't want Telegram integrated with your Moodle account any more:

	[[File:~~changessaved~~.png\|center\|600px]]		[[File:prefssaved.png\|center\|600px]]

	You can now select what notifications and messages you want received through Telegram.		You can now select what notifications and messages you want received through Telegram.

Mchurch at 13:38, 26 May 2017

2017-05-26T13:38:50Z

← Older revision		Revision as of 13:38, 26 May 2017
Line 38:		Line 38:

	NOTE: The "Setup Telegram webhook" option is still a work in progress.		NOTE: The "Setup Telegram webhook" option is still a work in progress.

			==Configuring user preferences==

			Once you have a Telegram bot configured, users can connect their Telegram accounts to receive notifications and messages. This is done in the user preferences screen under the notification preferences.
			As a user, navigate to the "Notification preferences" screen. One the columns will be Telegram, and it will show that it is not configured. Click on the configuration link/icon and the Telegrams settings dialogue will open up:

			[[File:telegrampreferences1.png\|center\|600px]]

			At this point, the user needs to initiate a conversation with the Telegram bot that was created for the site. The dialogue offers a link to start this. Click on the "Connect my account to Telegram", and another browser window/tab will open:

			[[File:telegramopenrequest.png\|center\|600px]]

			Use the "Open Telegram app" to launch the Telegram app and initiate the conversation with the Telegram bot. You will see the conversation with a "Start" button at the bottom:

			[[File:moodlebotstart.png\|center\|600px]]

			Click "Start". A conversation will start like below:

			[[File:moodlebotstarted.png\|center\|600px]]

			At this point, return to your Moodle browser window/tab:

			[[File:savechanges.png\|center\|600px]]

			Click "Save changes", and your Telegram connection should be configured. If it isn't (there could be a delay), wait a bit and open the settings dialogue again, and click "Save changes". Note, that if you do not click the save changes before logging off, you will need to start the connect process again. In any case, once you have saved, and the connection is made, you will see that the alert icon is gone, and when you look at your settings, it will give you a link to disconnect your account. Don't use that unless you don't want Telegram integrated with your Moodle account any more:

			[[File:changessaved.png\|center\|600px]]

			You can now select what notifications and messages you want received through Telegram.

Mchurch at 19:55, 25 May 2017

2017-05-25T19:55:30Z

← Older revision		Revision as of 19:55, 25 May 2017
Line 15:		Line 15:
	Open the link in the Telegram app (you need that), or alternatively in the Telegram Web (if your browser allows it). In Telegram, you should see this:		Open the link in the Telegram app (you need that), or alternatively in the Telegram Web (if your browser allows it). In Telegram, you should see this:

	[[File:telegramstartscreen.png]]		[[File:telegramstartscreen.png\|center\|600px]]

	Click the "Start" button at the bottom to begin the conversation with Botfather. Once you have, you will see:		Click the "Start" button at the bottom to begin the conversation with Botfather. Once you have, you will see:

	[[File:botfatherstart.png]]		[[File:botfatherstart.png\|center\|600px]]

	Enter the command "/newbot" in the conversation, and Botfather will ask you for all of the information you need. You will need to enter both a name and a unique username for your Bot. The Telegram settings screen provided some suggestions, but you can choose what you want. Since it should be unique, it is recommended you use your organization or sitename as part of these.		Enter the command "/newbot" in the conversation, and Botfather will ask you for all of the information you need. You will need to enter both a name and a unique username for your Bot. The Telegram settings screen provided some suggestions, but you can choose what you want. Since it should be unique, it is recommended you use your organization or sitename as part of these.

	[[File:newbot.png]]		[[File:newbot.png\|center\|600px]]

	Once you have given Botfather everything it needs, you will gave the bot token displayed in the conversation:		Once you have given Botfather everything it needs, you will gave the bot token displayed in the conversation:

	[[File:bottoken.png]]		[[File:bottoken.png\|center\|600px]]

	Transfer the bot token information to the settings screen and hit "Save changes":		Transfer the bot token information to the settings screen and hit "Save changes":

	[[File:savechanges.png]]		[[File:savechanges.png\|center\|600px]]

	The name and username you chose will be filled in for you. Telegram is now ready for your users to configure their message preferences.		The name and username you chose will be filled in for you. Telegram is now ready for your users to configure their message preferences.

	[[File:finalsettings.png]]		[[File:finalsettings.png\|center\|600px]]

	NOTE: The "Setup Telegram webhook" option is still a work in progress.		NOTE: The "Setup Telegram webhook" option is still a work in progress.

Mchurch at 19:47, 25 May 2017

2017-05-25T19:47:30Z

← Older revision		Revision as of 19:47, 25 May 2017
Line 11:		Line 11:
	The only thing you really need to enter here is the "bot token for the site". The other two fields will be automatically filled in once you save the token. To get the token, you need to open the Botfather in Telegram, which you can do by clicking the provided link below the instructions. When you click it, you will see something like this:		The only thing you really need to enter here is the "bot token for the site". The other two fields will be automatically filled in once you save the token. To get the token, you need to open the Botfather in Telegram, which you can do by clicking the provided link below the instructions. When you click it, you will see something like this:

	[[File:opentelegram.png\|600px~~\|center~~]]		[[File:opentelegram.png\|center\|600px]]

			Open the link in the Telegram app (you need that), or alternatively in the Telegram Web (if your browser allows it). In Telegram, you should see this:

			[[File:telegramstartscreen.png]]

			Click the "Start" button at the bottom to begin the conversation with Botfather. Once you have, you will see:

			[[File:botfatherstart.png]]

			Enter the command "/newbot" in the conversation, and Botfather will ask you for all of the information you need. You will need to enter both a name and a unique username for your Bot. The Telegram settings screen provided some suggestions, but you can choose what you want. Since it should be unique, it is recommended you use your organization or sitename as part of these.

			[[File:newbot.png]]

			Once you have given Botfather everything it needs, you will gave the bot token displayed in the conversation:

			[[File:bottoken.png]]

			Transfer the bot token information to the settings screen and hit "Save changes":

			[[File:savechanges.png]]

			The name and username you chose will be filled in for you. Telegram is now ready for your users to configure their message preferences.

			[[File:finalsettings.png]]

			NOTE: The "Setup Telegram webhook" option is still a work in progress.

Mchurch: /* Configuring the plugin settings */

2017-05-25T19:36:30Z

Configuring the plugin settings

← Older revision		Revision as of 19:36, 25 May 2017
Line 7:		Line 7:
	After you have installed the plugin, at the settings screen, you will see this:		After you have installed the plugin, at the settings screen, you will see this:

	[[File:Settingscreen.png\|600px]]		[[File:Settingscreen.png\|600px\|center]]

			The only thing you really need to enter here is the "bot token for the site". The other two fields will be automatically filled in once you save the token. To get the token, you need to open the Botfather in Telegram, which you can do by clicking the provided link below the instructions. When you click it, you will see something like this:

			[[File:opentelegram.png\|600px\|center]]

Mchurch at 19:30, 25 May 2017

2017-05-25T19:30:49Z

← Older revision		Revision as of 19:30, 25 May 2017
Line 6:		Line 6:

	After you have installed the plugin, at the settings screen, you will see this:		After you have installed the plugin, at the settings screen, you will see this:
	[[File:~~Example~~.~~jpg~~]]
			[[File:Settingscreen.png\|600px]]

Mchurch at 19:26, 25 May 2017

2017-05-25T19:26:10Z

← Older revision		Revision as of 19:26, 25 May 2017
Line 1:		Line 1:
	~~{{Telegram message output plugin}}~~
	This plugin provides a message processor for Telegram, allowing sites to configure a Telegram bot that their users can configure to forward Moodle notifications and messages to their Telegram account.		This plugin provides a message processor for Telegram, allowing sites to configure a Telegram bot that their users can configure to forward Moodle notifications and messages to their Telegram account.

Mchurch: Created page with "{{Telegram message output plugin}} This plugin provides a message processor for Telegram, allowing sites to configure a Telegram bot that their users can configure to forward..."

2017-05-25T19:22:48Z

Created page with "{{Telegram message output plugin}} This plugin provides a message processor for Telegram, allowing sites to configure a Telegram bot that their users can configure to forward..."

New page

{{Telegram message output plugin}}
This plugin provides a message processor for Telegram, allowing sites to configure a Telegram bot that their users can configure to forward Moodle notifications and messages to their Telegram account.

==Configuring the plugin settings==

At the Telegram main settings page (Plugins / Message outputs / Telegram), you will need to configure a bot token to be used by the site. To get this token, you will need to create a new Telegram bot using the Telegram bot "Botfather".

After you have installed the plugin, at the settings screen, you will see this:
[[File:Example.jpg]]