En un post previo te enseñé a enviar un mensaje en nombre de un Bot de Telegram usando JavaScript del lado del cliente.

Hoy vamos a ver cómo enviar un mensaje desde la línea de comandos con cURL, de modo que vamos a usar un Bot de Telegram desde cURL para enviar un simple mensaje.

Nota: en este post asumo que ya tienes tu token del bot, mismo que el BotFather te debió brindar. Si no, solo habla con él en https://t.me/botfather y crea un nuevo bot para obtener tu token.

Especificación de la API de Telegram

Entonces, para comunicarte con un usuario de Telegram como si fueras un bot desde la terminal debes hacer una petición a:

https://api.telegram.org/botTOKEN/sendMessage

Por ejemplo, si tu bot tiene el token 123:asd la URL sería:

https://api.telegram.org/bot123:asd/sendMessage

La petición es de tipo POST y debes enviar un JSON con las propiedades chat_id y text. El chat_id es el id del usuario, canal o grupo al que quieres enviar el mensaje y el text es el mensaje que vas a enviar desde la línea de comandos con cURL hacia Telegram sin librerías.

Vas a encontrar más detalles sobre sendMessage en: https://core.telegram.org/bots/api#sendmessage

Token e id

En este post asumo que ya tienes tu token del Bot, mismo que el BotFather te debió brindar. Si no, solo habla con él en https://t.me/botfather y crea un nuevo Bot para obtener tu token.

También estoy suponiendo que ya conoces el id de chat, grupo o canal. Si no lo tienes puedes obtener el id de usuario reenviando un mensaje al Bot https://t.me/get_id_bot o https://t.me/JsonDumpBot (no estoy afiliado ni tengo relación con ellos) y estoy seguro de que debe haber distintas maneras de obtenerlo

Enviar mensaje a Telegram con cURL

Ahora que conocemos la API, podemos consumirla desde cURL ya sea con Windows o Linux, siempre desde la terminal.

Para ello invocamos a la URL previamente indicada y especificamos el encabezado Content-Type: application/json con -H. Este paso es muy importante.

Los datos, codificados como JSON y escapados, deben enviarse en la propiedad -d así que la sintaxis es:

curl -X POST https://api.telegram.org/botTOKEN/sendMessage -H "Content-Type: application/json" -d "{\"chat_id\":\"el id de chat\",\"text\":\"Mensaje\"}"

Fíjate que yo estoy especificando los datos con comillas dobles, y al codificarlas con JSON también se usan las comillas dobles, así que las estoy escapando con \.

Me parece que la API ofrece varias maneras de enviar los datos (incluso como parámetros GET en la URL), pero en este caso lo he hecho con JSON. Al ejecutar el comando habremos enviado un mensaje desde cURL hacia Telegram.

Para enviar un mensaje a Telegram desde cURL simplemente tienes que seguir la especificación de la API. Al ser una API HTTP REST es muy fácil consumirla desde varios lugares.

Los detalles están en: https://core.telegram.org/bots/api