Download hangoutsbot - download do código-fonte hangoutsbot

hangoutsbot

Código-Fonte de IA

Patch release

Baixar

Introdução

Hangupsbot é um chatbot projetado para trabalhar com o Google Hangouts.

Por favor veja:

Instruções para instalação
Rastreador de problemas para bugs, problemas e solicitações de recursos
Wiki para todo o resto

Links de repositório

Organização GitHub
Projeto de Tradução
Biblioteca de Hangups de referência

Características

Menções : se alguém mencionar você em uma sala, receba um hangout privado do bot com detalhes sobre a menção, incluindo contexto, sala e pessoa que mencionou você.
Syncouts : um synout são dois chats em grupo do Hangout que têm suas mensagens encaminhadas entre si, permitindo uma interação perfeita entre as duas salas. Usado principalmente para superar o limite de bate-papo de 150 membros, mas também pode ser usado para conectar equipes temporariamente para interagir.
Syncouts de bate-papo cruzado : metade da sua equipe está no Slack? Sem problemas! Você pode conectá-los na mesma sala para se comunicarem. Suporte para outros clientes de chat em breve.
Integração Hubot : O Hangupsbot permite que você se conecte ao Hubot, fornecendo acesso instantâneo a centenas de ferramentas de bate-papo e plug-ins desenvolvidos.
Plugins e sinks : O bot possui instruções para desenvolver seus próprios plugins e sinks, permitindo que o bot interaja com serviços externos como o site da sua empresa, scripts do Google e muito mais.
Mania de plug-ins : jogos, suporte a apelidos, palavras-chave inscritas, API personalizável - a lista continua !

Executando o bot

Nota: Primeira execução? Veja as instruções de instalação

Para executar: 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

Configuração de bot para administradores

As diretivas de configuração podem ser especificadas em config.json .

Observe que o arquivo config.json fornecido com o repositório não deve ser editado/alterado. É o arquivo de referência usado pelo bot para criar o arquivo de configuração real localizado em outro lugar do sistema. Para descobrir onde está o arquivo real, consulte a seção Configuração Adicional nas instruções de instalação.

A maioria das diretivas de configuração são especificadas globalmente

As diretivas globais são sempre especificadas na "raiz" de config.json .
Para especificar uma diretiva por conversa, a mesma opção de configuração deve ser definida como config.conversations[<conversation-id>].<configuration option> .
As diretivas por conversa substituem as configurações globais, se ambas estiverem definidas.
As diretivas por conversa configuradas manualmente estão obsoletas.

Plug-ins

A chave plugins em config.json permite que você especifique opcionalmente uma lista de plugins que serão carregados pelo bot na inicialização. Se esta opção for deixada como null , todos os plugins disponíveis serão carregados.

Para especificar os plug-ins a serem carregados, primeiro certifique-se de que os arquivos .py corretos estejam dentro do diretório hangupsbot/plugin/ e, em seguida, modifique a chave plugins em config.json para refletir quais plug-ins/arquivos você deseja carregar, por exemplo, plugins: ["mentions", "default", "chance", "syncrooms"]

Alguns plugins podem exigir configuração extra. config.json é o provedor de configuração do bot e seus plug-ins.

Alguns plug-ins interessantes:

menciona plugin
- alertar os usuários quando seus nomes forem mencionados em um bate-papo
plugin de assinatura
- alertar os usuários quando palavras-chave nas quais eles estão inscritos são ditas em um bate-papo
Plug-ins de sincronização / sincronização
- retransmitir mensagens de bate-papo entre diferentes conversas em grupo de hangouts (sincronizações)
- configurar via comandos de bot (syncrooms_config)
- tradução automática via Google Translate de mensagens retransmitidas (syncrooms_autotranslate)

O wiki tem uma lista mais abrangente de plugins ...

Interagindo com o bot

Existem dois tipos gerais de interações com o bot:

Os comandos /bot começam com /bot por exemplo, /bot dosomething
- alguns comandos de bot são apenas de administrador
interações personalizadas (o uso e a acessibilidade variam de acordo com o plugin)

O bot base suporta alguns comandos básicos mesmo sem nenhum plugin carregado. Aqui está uma lista parcial:

/bot help

O bot lista todos os comandos suportados em uma mensagem privada com o usuário

/bot ping

Bot responde com um pong .

/bot version

O bot responde com o número da versão do framework

Uma lista completa de comandos suportados pela estrutura base está disponível na página wiki Core Commands .

O wiki também possui uma lista de plug-ins detalhando os plug-ins disponíveis com listas de comandos e uso.

Atualizando

Navegue até o diretório do bot (por exemplo, cd ~/hangupsbot )
Mude para o branch estável mais recente usando git checkout master
git pull para obter a versão mais recente do hangupsbot
pip3 install -r requirements.txt --upgrade
Reinicie o bot

Depuração

Execute o bot com o parâmetro -d , por exemplo, python3 hangupsbot.py -d - isso reduz o nível de log para INFO para obter um arquivo de log mais detalhado e informativo.
tail o arquivo de log, que provavelmente está localizado em /<user>/.local/share/hangupsbot/hangupsbot.log - a localização varia de acordo com a distribuição!
A saída do console (STDOUT) é bastante limitada, qualquer que seja o nível de log, portanto, confie na saída do arquivo de log.

Dicas para solução de problemas

O programa não está em execução:

Atualizar hangupsbot e hangups
Execute hangups para verificar se a biblioteca original de hangups está funcionando
- Se houver erros, exclua o cookie em ``~/.local/share/hangupsbot/cookies.json` e tente novamente
- Faça login em sua conta do Google a partir do endereço do servidor.

O bot não está respondendo às mensagens: