.. _gnrextra/genrobot/telegram:

Service Telegram
================




Il service Telegram permette di aggiungere BOT Telegram, assegnare contatti, definire i comandi del BOT.

Prerequisito del service Telegram è la libreria Pyrogram, installabile con questi comandi::

  pip install pyrogram==0.18
  pip install TgCrypto
  

.. hint::
  Al momento il service funziona esclusivamente con una versione di Pyrogram antecedente alla 1.0 rilasciata ad agosto 2020 (l'ultima disponibile è la 0.18). Si prevede comunque un aggiornamento del service che rimuoverà questo limite
  
Una volta installati i prerequisiti, per istanziare il service è necessario innanzitutto creare un'APP Telegram su https://core.telegram.org. Una volta creata l'APP verranno generate un'API ID e un'API Hash, che sarà possibile inserire nel file instanceconfig.xml della nostra istanza o alternativamente nell'instanceconfig di default di Genropy (``.gnr/instance/default.xml``)::

  <api_keys>
		<telegram api_id="XXXXXXX" api_hash="8b1cfd24...........15f4c" />
  </api_keys>

All'aggiunta del service sarà possibile inserire uno o più BOT, indicando semplicemente il BOT Token fornito direttamente da BOTFather (https://t.me/botfather).

.. raw:: html

    <hr>
    
**Reference**

API Telegram: https://core.telegram.org/

Pyrogram Documentation: https://docs.pyrogram.org/

.. sectionauthor:: Davide Paci