====== Telegram ======

Programa de mensajería instantánea.

  * [[https://telegram.org/|Web oficial]]

Versiones para Linux, Windows, macOS, Android e iOS.

Características:

  * Simple
  * Privado: los mensajes están fuertemente cifrados y se pueden autodestruir.
  * Sincronizado: Permite que accedas a tus chats desde múltiples dispositivos.
  * Rápido
  * Poderoso: no tiene límites para el tamaño de tu multimedia y chats.
  * Abierto: tiene una API y un código fuente a disposición de todos.
  * Seguro: Mantiene tus mensajes a salvo de ataques de hackers.
  * Social: Sus grupos permiten hasta 200.000 miembros.

===== Chats =====

===== Grupos =====



===== Canales =====

Los canales son una herramienta para difundir mensajes a grandes audiencias. A diferencia de los grupos, son de una vía, es decir, los administradores del canal publican mensajes, pero no los suscriptores.

Un canal puede tener un número ilimitiado de suscriptores.

Cada mensaje en un canal tiene un contador de vistas que se actualiza cuando el mensaje es visto, incluyendo las copias que son reenviadas.

Existen canales **públicos** y canales **privados**:

  * Canales públicos: Cualquiera puede encontrarlos a través de la búsqueda en Telegram y unirse. 
  * Canales privados: son sociedades cerradas, por lo que necesitas ser añadido por el propietario u obtener un enlace de invitación para unirte.

El propietario de un canal puede difundir mensajes, eliminar cualquier mensaje, añadir suscriptores (sólo los primeros 200), eliminar suscriptores, cambiar el nombre del canal, la imagen de perfil y el enlace, así como eliminar el canal completamente. El propietario puede, además, añadir o quitar administradores para que le ayuden a gestionar el canal.

Puedes dar permisos de administración a cada administrador individual cuando los promuevas.

Para crear un canal:

  * Android: Pulsa sobre el icono del lápiz, en la lista de chats. Luego, 'Nuevo canal'.

===== Bots =====

Los bots son aplicaciones que cualquier usuario puede programar y que se ejecutan dentro de Telegram. Los usuarios pueden interactuar con los bots enviándoles mensajes, comandos o peticiones en línea. Todo se hace utilizando peticiones HTTPS a la API de Telegram.

  - Para [[https://core.telegram.org/bots#3-how-do-i-create-a-bot|crear un bot]], se abre una conversación con el bot BotFather y se usa el comando ''/newbot''. Seguimos las indicaciones
  - Averiguar el token del bot

Una vez creado, si le hablamos, podemos ver lo que recibe desde ''https://api.telegram.org/bot<TOKEN_BOT>/getUpdates''. Esto es útil para conocer el identificador del chat que hemos iniciado con el bot y así saber cómo enviar mensajes desde el bot a nuestro usuario.

Ejemplo de la respuesta JSON:

<code javascript>
{
    "ok":true,
    "result":[
        {
            "update_id":123456789,
            "message":{
                "message_id":34,
                "from":{
                    "id":123456,
                    "is_bot":false,
                    "first_name":"TempWin",
                    "username":"tempwin",
                    "language_code":"es"
                },
                "chat":{
                    "id":123456,
                    "first_name":"TempWin",
                    "username":"tempwin",
                    "type":"private"
                },
                "date":1635500932,
                "text":"hola"
            }
        },
        {
            "update_id":123456789,
            "message":{
                "message_id":35,
                "from":{
                    "id":123456,
                    "is_bot":false,
                    "first_name":"TempWin",
                    "username":"tempwin",
                    "language_code":"es"
                },
                "chat":{
                    "id":123456,
                    "first_name":"TempWin",
                    "username":"tempwin",
                    "type":"private"
                },
                "date":1635500958,
                "text":"foo"
            }
        }
    ]
}
</code>

==== cURL ====

Para hacer peticiones a la API de Telegram, la manera más sencilla es a través de cURL:

<code bash>
curl -X POST -H \
     -H 'Content-Type: application/json' \
     -d '{"chat_id": "123456", "text": "Mensaje desde cURL", "disable_notification": true}' \
     https://api.telegram.org/bot<TOKEN_BOT>/sendMessage 
</code>


Se puede consultar la documentación oficial de la [[https://core.telegram.org/bots/ap|API de Telegram]]. Además, se enlazan [[https://core.telegram.org/bots/samples|ejemplos de uso]] de bots de Telegram en diferentes lenguajes de programación.

Más información en esta misma wiki:

  * [[informatica:programacion:php:snippets:telegram|PHP Snippets: Telegram]]
  * [[informatica:programacion:python:modulos:python-telegram-bot|Python: python-telegram-bot]]

===== Telegra.ph =====

Telegra.ph es una herramienta minimalista de publicación que permite crear artículos y publicarlos en la web en un click. Los artículos de Telegraph se generan en Telegram como páginas [[https://telegram.org/blog/instant-view|Instant View]].

  * [[https://telegra.ph/|Telegraph]]
  * [[https://telegra.ph/api|Telegraph API]]

Aunque cualquiera puede usar la herramienta (no se necesita Telegram), si utilizamos el bot ''@Telegraph'' podremos gestionar los artículos, editarlos, etc.