Bots de Telegram des del shell de linux/mac i powershell

Tocatejant un codi fet amb C# he vist que al acabar enviava un missatge per un bot de telegram. He trobat ridiculament senzill així que he dicidit buscar els diversos modes per poder fer-ho des de batch scripts.

Bàsicament el que fem és cridar una URL adjuntant uns POST, aquests post enviarem el text del missatge, enviarem per formatar el text (negreta, cursiva) i l’identificador de chat.

Si no sabeu com trobar l’identificador dedueixo que encara no heu creat el vostre Bot i, per tant, tampoc teniu el token per poder comunicar amb ell. Així doncs passem a explicar com aconseguir-los:

Gran part d’aquesta documentació la trobeu al lloc oficial: https://core.telegram.org/bots#botfather

En aquest lloc que acabo de mencionar tenim un link al botfather (un acudit amb “El padrino” “The Godfather”) en la que ens diuen que li obrim un xat per tal d’obtenir mes informació: https://telegram.me/botfather

Un cop obert, presionem start (com solen funcionar els bots a telegram) i utilitzem o fem click a /newbot per tal de comenar el procés i obtenir el nostre bot. Primer ens preguntarà quin nom volem que tingui el nostre Bot, el que sortirà representat ens els xats i llavors, ens demanarà quin nom d’usuari tindrà. Com que tots som molt espavilats i segurament creem elmeunickbot, suggereix que el nom d’usuari sigui elmeunick_bot però, en el meu cas ha fallat però això són figues d’un altre paner.

Un cop li hem donat els noms, ens assigna un token i ens recorda la importància d’aquests, que el guardem ben guardat i que no el perdem. Falta rès? Clar que sí, falta l’identificador de xat i per això abans hem d’iniciar un xat amb el nostre bot. En l’últim missatge de @botfather ens facilita també el link per obrir el xat t.me/elmeunick_bot (o el que us hagi acceptat…), al igual que amb els altres bots, prenem start (o enviem /start) i ja tindrem un xat obert amb ell. Ara toca obtenir l’odentificador i tindrem que anar al navegador i posar la següent direcció:

https://api.telegram.org/botelvostretoken/getUpdates

ULL! Si sou vius no cal que us aviso, però per si a un cas aneu amb embranzida i ja ewsteu fent copia i enganxa, heu de substituir elvostretoken per el token que us ha donat @botfather!

Un cop fet, us retorna una cadena de text Json (utilitzeu el visualitzador que mes us agradi) i localitzem l’entrada “chat” i el seu valor “id”:

"chat": {
  "id": 123456789,
  "first_name": "Pere Porter",
  "username": "perebotero",
  "type": "private"
}

En l’exemple que us poso, serà “123456789”, un cop ja tenim el token i l’identificador, sols caldà modificar els scripts per tal que funcionin al vostre gust. En tot cas, fem una dissecció del que hem de fer per tal d’enviar un missatge.

Com us he dit enviarem un POST DATA junt a la crida de la URL i podem fer-ho de diverses maneres, la més senzilla i ràpida, és en la mateixa adreça:

http://www.kamencesc.com/test?post1=valor&post2=23

Les dades que enviem son:

  • post1 amb un valor de text “valor”
  • post2 amb un valor numèric de 23

L’altre forma és identificant a part aquests valors, us presento els dos casos en tres scripts diferents.

Powershell

$MyToken = "987654321:AAFYBL1Q9vNBceeAJNDLNkRaFUaq5pVnqkc"
 $chatID = 123456789
 $Message = "Missatge des de ***Powershell***"
$Parse_mode = "Markdown"
 $Response = Invoke-RestMethod -Uri "https://api.telegram.org/bot$($MyToken)/sendMessage?chat_id=$($chatID)&parse_mode=$($Parse_mode)&text=$($Message)"

Executem l’script canviant les nostres dades al gust i ja tindrem el nostre missatge en el xat. Així de puntetes, passem pel parse_mode que és el que ens permet fer servir negreta (amb el *** [tres estariscos] al principi i final del que volem posar en negreta) o en cursiva (amb ___ [tres guions baixos] al principi i final). Us deixo un enllaç a la documentació ja que hi ha més opcions per poder utilitzar fins i tot codi html.

https://core.telegram.org/bots/api#formatting-options

Linux – wget

chat_id="123456789"
token="987654321:AAFYBL1Q9vNBceeAJNDLNkRaFUaq5pVnqkc"
bot_text="Missatge des de linux amb ***wget***"
wget --post-data="chat_id=$chat_id&parse_mode=Markdown&text=$bot_text" https://api.telegram.org/bot$token/sendMessage

Com podeu veure, aqui indiquem la POST DATA amb anterioritat i no enganxat amb la URL com el cas del Powershell, però el resultat és el mateix.

Linux – curl

 chat_id="123456789"
token="987654321:AAFYBL1Q9vNBceeAJNDLNkRaFUaq5pVnqkc"
bot_text="Missatge des de linux amb ***wget***"
curl -s -X POST https://api.telegram.org/bot$token/sendMessage -d chat_id=$chat_id -d pase_mode="Markdown" -d text="$bot_text" > /dev/null

En el cas de curl, indicarem cada POST DATA amb -d nom=valor totes per separat. Finalment, per tal de no obtenir un valor de resposta, posetm direccionem la sortida cap a /dev/null (recordeu treure això si esteu testejant i no us arriba el missatge).

Aquests són les tres formes que podem trobar per enviar missatges al nostre bot des batch scripting amb shell i powershell, per tant Linux (necesitem wget o curl), Mac (necessitem wget o curl)i Windows.

Espero que us serveixi, és ideal per fer crides des de crontab cada x temps amb valors de lectura amb una raspberry pi per exemple, o al finalitzar scripts rutinaris i rebre un petit informe al final d’aquests.

En un altre post mirarem com enviar documents! Estigueu al cas!

Monitor en mode Estalvi d’energia amb PowerShell

Seguint amb les ulilitats que pot donar el meu Stream Deck de Elgato i que anteriorment ja n’he parlat sobre treure profit amb Powershell.

Canvi de dispositius d’audio amb PowerShell

Com alguns podeu saber, el meu escriptori és el terra, tinc el meu setup (monitors, stream deck, micro, etc) tot al terra davant la TV i moltes vegades em passa que vull veure la TV inmediatament i tinc que tancar els monitors perquè no molestin, així que vaig pensar que potser amb PowerShell podría fer-ho.

Una cerca ràpida per google em va portar a Windows Tip: 4 Different Ways to Turn Off Desktop Monitor or Laptop Screen ón expliquen entre altres coses, una crida amb un script de PowerShell.

Copiar i enganxar i l’script funciona perfectament, configuro tal i com vaig fer amb els altre botons de l’Stream Deck i els monitors entren en estalvi d’energia, l’únic inconvenient és que la finestra de PowerShell queda oberta i no m’interessa, molesta trobarla oberta al despertar els monitors.

function Set-DisplayOff
{
	$code = @"
	using System;
	using System.Runtime.InteropServices;
	public class API
	{
		[DllImport("user32.dll")]
		public static extern
		int SendMessage(IntPtr hWnd, UInt32 Msg, IntPtr wParam, IntPtr lParam);
	}
	"@
	$t = Add-Type -TypeDefinition $code -PassThru
	$t::SendMessage(0xffff, 0x0112, 0xf170, 2)
}

Set-DisplayOff

Una mica més investigació m’ha portat a descobrir que a part de SendMessage existeix PostMessage, que és dintre de la API Win32 la versió asincrona de SendMessage i per tant no interfereix en el fil d’execució.

Així que el codi de l’script final queda tal que:

function Set-DisplayOff
{
	$code = @"
	using System;
	using System.Runtime.InteropServices;
	public class API
	{
		[DllImport("user32.dll")]
		public static extern
		int PostMessage(IntPtr hWnd, UInt32 Msg, IntPtr wParam, IntPtr lParam);
	}
	"@
	$t = Add-Type -TypeDefinition $code -PassThru
	$t::PostMessage(0xffff, 0x0112, 0xf170, 2)
}

Set-DisplayOff

Canvi de dispositius d’audio amb PowerShell

Després de comprar l’Stream Deck de Elgato li trobava a faltar la manera de poder canviar entre dispositius d’àudio en calent.

Les investigacions em varen portar cap a PowerShell però de sèrie no pot fer aquestes funcions (que sàpiga) però si amb aquesta extensió que vaig trobar a github:

AudioDeviceCmdlets: https://github.com/frgnca/AudioDeviceCmdlets

Amb ella podem llistar els dispositius (tant de reproducció com de gravació) i poder canviar-lo, a part de canviar valors com el volum, etc.

Amb aquesta comanda llistem els dispositius

PS C:\Users\User> Get-AudioDevice -list

Index : 1
Default : False
Type : Playback
Name : Altavoces (Steam Streaming Microphone)
ID : {0.0.0.00000000}.{1a5fae48-a964-4d5a-ba5c-509e63ea6afd}
Device : CoreAudioApi.MMDevice

Index : 2
Default : True
Type : Playback
Name : Altavoces (Realtek High Definition Audio)
ID : {0.0.0.00000000}.{265fcc99-7fa6-4fa2-97bf-93236b4a1391}
Device : CoreAudioApi.MMDevice

Index : 3
Default : False
Type : Playback
Name : BenQ PD2500Q (NVIDIA High Definition Audio)
ID : {0.0.0.00000000}.{45ef6901-5ee0-4752-a0d9-d2fad76fe12c}
Device : CoreAudioApi.MMDevice

Index : 4
Default : False
Type : Playback
Name : Altavoces (Steam Streaming Speakers)
ID : {0.0.0.00000000}.{5deb3169-df93-4c68-b73d-a576584badc6}
Device : CoreAudioApi.MMDevice

Index : 5
Default : False
Type : Recording
Name : Línea de entrada (Realtek High Definition Audio)
ID : {0.0.1.00000000}.{17278a24-459b-4768-b332-b553a81ec097}
Device : CoreAudioApi.MMDevice

Index : 6
Default : False
Type : Recording
Name : Micrófono (Steam Streaming Microphone)
ID : {0.0.1.00000000}.{1bd0aa36-eedd-48a6-a9a5-404e80a7bc14}
Device : CoreAudioApi.MMDevice

Index : 7
Default : True
Type : Recording
Name : Micrófono (HD Pro Webcam C920)
ID : {0.0.1.00000000}.{2831395a-a41e-4285-9078-cb3558e5a024}
Device : CoreAudioApi.MMDevice

Necessitem l’Index al que volem canviar i podem canviar llençant aquesta comanda:

Set-Audiodevice -Index <yournumber>

Amb aquesta comanda ja tindrem canviat el dispositiu, però, com ho podem cridar? Si intentem cridar directament un fitxer d’script ens trobem que no tenim permisos per executar el (nostre propi) script, que per cert, són amb extensió ps1.

Tenim dos opcions, autoritzar TOTS els permisos i per tant no tenir problemes, o per altre part cridar powershell.exe amb alguns comandament extra quan cridem l’script.

powershell -executionPolicy bypass -file "c:\path\to\file\haedphones.ps1"

Amb això saltem els permisos d’execució de l’script… ehm… sí… amb aquesta comanda i jasta, seguretat a tope a powrshell si pots llançar powrshell des de linia de comandes… “hurra”

Evidentment tindrem que fer un altres script per tornar al dispositiu anterior, “obvious”.

Espero que us hagi servit ;)

Nou sistema de decarrega 3alacarta (part 1)

Avui he volgut posar-me a intentar recuperar una eina que tenia una mica oblidada i que había modificat per mí, el gnulinux.cat tv3 que fa molt bé la seva feina però es va deixar d’actualitzar de fa molt temps.

Els developers es van posar en contacte amb mí per afegir-me al projecte (gràcies per pensar amb mí!) però alguna cosa vaig fer malament i m’han suprimir (o no vaig arribar a crear) la meva compra de SourceForge.net… un desastre.

» Read more