.. _gnrextra/genrobot/genrobot_intro:

Introduzione
============




Il package Genrobot permette di utilizzare i BOT di Telegram per inviare e ricevere messaggi e notifiche automatiche. Una volta configurato il  :ref:`Service Telegram<gnrextra/genrobot/telegram>`  sarà possibile aggiungere uno o più BOT, aggiungere dei contatti con cui interagire, oppure, se è attivo anche il  :ref:`package SOCIAL<gnrextra/social>` , collegare dei Gruppi o dei Canali su cui pubblicare attraverso i BOT.

Includere il package GENROBOT nel progetto
------------------------------------------
Il package BOT è incluso nel «gnrextra» di Genropy, e può quindi essere facilmente incluso in tutti i progetti semplicemente modificando il file instanceconfig.xml come segue::

  <packages>
       <gnrextra_genrobot pkgcode="gnrextra:genrobot"/>
  </packages>

Una volta lanciata una *gnrdbsetup* per generare la struttura del database troveremo le impostazioni del package nella voce di menu ``Genrobot``

Modalità di attivazione del service
-----------------------------------
Il service può essere avviato in due modalità:

- una prima modalità, esclusivamente **attiva**, prevede la possibilità di "accendere" il service esclusivamente al bisogno prima di una pubblicazione. È il caso della pubblicazione su canali o gruppi, per i quali si rimanda alla documentazione dedicata sul  :ref:`package SOCIAL<gnrextra/social>` , o di notifica dell'aggiornamento della documentazione

- una seconda modalità, **sia attiva che passiva**, permette di lascere atteso in ascolto il BOT sul nostro server, e ottenere in questo modo anche dati in ricezione (esempio, i comandi attivati dagli utenti), allo scopo di fornire risposte automatiche o attivare meccanismi di vario genere. Questa seconda modalità prevede l'utilizzo del `gnrserviceworker <https://www.genropy.org/docs/service/funzionamento_service.html#modalita-passiva-gnrserviceworker>`_

.. sectionauthor:: Davide Paci