Téléchargement de hangoutsbot - Téléchargement du code source hangoutsbot

hangoutsbot

Code Source AI

Patch release

Télécharger

Introduction

Hangupsbot est un chatbot conçu pour fonctionner avec Google Hangouts.

Veuillez consulter :

Instructions pour l'installation
Suivi des bugs, des problèmes et des demandes de fonctionnalités
Wiki pour tout le reste

Liens vers le référentiel

Organisation GitHub
Projet de traduction
Bibliothèque de références Hangups

Caractéristiques

Mentions : si quelqu'un vous mentionne dans une salle, recevez un hangout privé du bot avec des détails sur la mention, y compris le contexte, la salle et la personne qui vous a mentionné.
Synchronisations : une synchronisation est constituée de deux discussions de groupe Hangout dont les messages sont transmis l'un à l'autre, permettant une interaction transparente entre les deux salles. Principalement utilisé pour dépasser la limite de 150 membres dans le chat, mais il peut également être utilisé pour connecter temporairement des équipes entre elles pour interagir.
Synchronisations cross-chat : La moitié de votre équipe est sur Slack ? Aucun problème! Vous pouvez les connecter dans la même pièce pour communiquer. Prise en charge d'autres clients de chat à venir.
Intégration Hubot : Hangupsbot vous permet de vous connecter à Hubot, vous donnant instantanément accès à des centaines d'outils de chat et de plugins développés.
Plugins et récepteurs : le bot contient des instructions pour développer vos propres plugins et récepteurs, permettant au bot d'interagir avec des services externes tels que le site Web de votre entreprise, les scripts Google et bien plus encore.
Plugin mania : jeux, support de pseudos, mots-clés abonnés, API personnalisable - la liste est longue !

Exécuter le robot

Remarque : Première exécution ? Voir les instructions d'installation

Pour exécuter : python3 hangupsbot.py

 usage: hangupsbot [-h] [-d] [--log LOG] [--cookies COOKIES] [--memory MEMORY] [--config CONFIG] [--version]

optional arguments:
-h, --help         show this help message and exit
-d, --debug        log detailed debugging messages (default: False)
--log LOG          log file path (default:
                   ~/.local/share/hangupsbot/hangupsbot.log)
--cookies COOKIES  cookie storage path (default:
                   ~/.local/share/hangupsbot/cookies.json)
--memory MEMORY    memory storage path (default:
                   ~/.local/share/hangupsbot/memory.json)
--config CONFIG    config storage path (default:
                   ~/.local/share/hangupsbot/config.json)
--version          show program's version number and exit

Configuration du bot pour les administrateurs

Les directives de configuration peuvent être spécifiées dans config.json .

Veuillez noter que le fichier config.json fourni avec le référentiel n'est pas censé être édité/modifié. Il s'agit du fichier de référence utilisé par le bot pour créer le fichier de configuration réel situé ailleurs dans le système. Pour savoir où se trouve le fichier réel, veuillez consulter la section Configuration supplémentaire dans les instructions d'installation.

La plupart des directives de configuration sont spécifiées globalement

Les directives globales sont toujours spécifiées dans la "racine" de config.json .
Pour spécifier une directive par conversation, la même option de configuration doit être définie comme config.conversations[<conversation-id>].<configuration option> .
Les directives par conversation remplacent les paramètres globaux, si les deux sont définis.
Les directives par conversation configurées manuellement sont obsolètes.

Plugins

La clé plugins dans config.json vous permet éventuellement de spécifier une liste de plugins qui seront chargés par le bot au démarrage. Si cette option est laissée sur null , alors tous les plugins disponibles seront chargés.

Pour spécifier les plugins à charger, assurez-vous d'abord que les fichiers .py corrects se trouvent dans votre répertoire hangupsbot/plugin/ , puis modifiez la clé plugins dans config.json pour refléter les plugins/fichiers que vous souhaitez charger, par exemple plugins: ["mentions", "default", "chance", "syncrooms"]

Certains plugins peuvent nécessiter une configuration supplémentaire. config.json est le fournisseur de configuration du bot et de ses plugins.

Quelques plugins intéressants :

mentionne le plugin
- alerter les utilisateurs lorsque leurs noms sont mentionnés dans un chat
plugin d'abonnement
- alerter les utilisateurs lorsque des mots-clés auxquels ils sont abonnés sont prononcés dans un chat
plugins de synchronisation/syncrooms
- relayer les messages de discussion entre différentes conversations de groupe Hangout (salles de synchronisation)
- configurer via les commandes du bot (syncrooms_config)
- traduction automatisée via Google Translate des messages relayés (syncrooms_autotranslate)

Le wiki a une liste plus complète de plugins ...

Interagir avec le robot

Il existe deux types généraux d’interactions avec le bot :

Les commandes /bot commencent par /bot par exemple /bot dosomething
- certaines commandes du bot sont réservées aux administrateurs
interactions personnalisées (l'utilisation et l'accessibilité varient selon le plugin)

Le bot de base prend en charge certaines commandes de base même sans aucun plugin chargé. Voici une liste partielle :

/bot help

Le robot répertorie toutes les commandes prises en charge dans un message privé avec l'utilisateur

/bot ping

Le robot répond avec un pong .

/bot version

Le bot répond avec le numéro de version du framework

Une liste complète des commandes prises en charge par le framework de base est disponible sur la page wiki Core Commands .

Le wiki contient également une liste de plugins détaillant les plugins disponibles avec des listes de commandes et leur utilisation.

Mise à jour

Accédez au répertoire du bot (par exemple cd ~/hangupsbot )
Passez à la dernière branche stable à l'aide git checkout master
git pull pour extraire la dernière version de hangupsbot
pip3 install -r requirements.txt --upgrade
Redémarrez le bot

Débogage

Exécutez le bot avec le paramètre -d , par exemple python3 hangupsbot.py -d - cela abaisse le niveau de journalisation à INFO pour un fichier journal plus détaillé et informatif.
tail le fichier journal, qui se trouve probablement dans /<user>/.local/share/hangupsbot/hangupsbot.log - l'emplacement varie selon la distribution !
La sortie de la console (STDOUT) est assez limitée quel que soit le niveau de journalisation, alors comptez plutôt sur la sortie du fichier journal.

Conseils de dépannage

Le programme ne fonctionne pas :

Mettre à jour hangupsbot et hangups
Exécutez hangups pour vérifier si la bibliothèque Hangups d'origine fonctionne
- S'il y a des erreurs, supprimez le cookie sur ``~/.local/share/hangupsbot/cookies.json` et réessayez
- Connectez-vous à votre compte Google à partir de l'adresse du serveur.

Le robot ne répond pas aux messages :