WeCom — Assistente de IA da Empresa

Imagine ter um colega superinteligente que mora dentro do WeChat da sua empresa — pronto para responder perguntas, enviar arquivos e resolver tarefas 24 horas por dia, 7 dias por semana. É exatamente isso que o Hermes Agent permite que você construa com o WeCom (WeChat Empresarial).

Por que WeCom + Hermes?

O WeCom é o aplicativo de mensagens empresariais da Tencent — pense nele como um WhatsApp para empresas. O Hermes conecta seu assistente de IA diretamente a ele, para que sua equipe possa conversar com o bot como conversaria com um colega de trabalho. Sem webhooks complicados, sem servidor público, sem dores de cabeça com TI. A conexão permanece aberta em segundo plano, como uma linha telefônica que nunca desliga.

Passo 1: Crie Seu Bot de IA (Do Jeito Fácil)

O caminho mais rápido é escanear um código QR. Execute isto no seu terminal:

hermes gateway setup

Selecione WeCom, e o Hermes exibirá um código QR. Escaneie-o com o aplicativo WeCom do seu celular, e o assistente criará automaticamente o bot com as permissões corretas. Ele ainda salva as credenciais para você.

Sem código QR? Sem problema. O assistente volta para o modo de entrada manual:

1. Faça login no Console de Administração do WeCom
2. Vá para Aplicativos → Criar Aplicativo → Bot de IA
3. Copie o ID do Bot e o Segredo
4. Execute hermes gateway setup novamente e cole-os quando solicitado

⚠️ Mantenha o Segredo em sigilo. Qualquer pessoa com acesso a ele pode se passar pelo seu bot.

Passo 2: Apresente Seu Bot ao Hermes

Você tem duas opções. O caminho interativo (recomendado):

hermes gateway setup

Siga as instruções para credenciais, controle de acesso e notificações.

Ou edite o arquivo de configuração diretamente. Abra ~/.hermes/.env e adicione:

WECOM_BOT_ID=seu-id-do-bot
WECOM_SECRET=seu-segredo
# Opcional: permitir apenas estes usuários
WECOM_ALLOWED_USERS=usuario1,usuario2
# Opcional: para onde enviar notificações
WECOM_HOME_CHANNEL=id_do_chat

Passo 3: Inicie o Gateway

Um comando e você está no ar:

hermes gateway

Pronto. Seu bot está online.

O Que Ele Pode Fazer?

• Mensagens diretas e chats em grupo — você decide quem pode falar com ele
• Permissões por grupo — lista de permissões para usuários específicos em cada grupo
• Suporte a mídia — envie e receba imagens, arquivos, voz e vídeo
• Respostas em tópicos — ele responde no mesmo tópico da conversa, mantendo o contexto claro
• Reconexão automática — se a conexão cair, ele tenta novamente silenciosamente em segundo plano

Uma Coisa para Saber

O adaptador WeCom envia cada resposta como uma mensagem completa — ele não digita caractere por caractere como o ChatGPT. Pense nisso como enviar um e-mail bem escrito em vez de um chat ao vivo. Isso é suficiente para a maioria das tarefas empresariais.

Considerações Finais

Configurar um assistente de IA para a empresa parece assustador, mas o Hermes faz parecer escanear um código QR em uma cafeteria. Comece com um grupo pequeno, teste com perguntas reais e depois expanda o acesso.

Dica prática: Antes de liberar para todos, use WECOM_ALLOWED_USERS para testar com apenas dois ou três colegas. Quando eles aprovarem, amplie o círculo. Seu bot vai conquistar seu lugar no chat da equipe rapidinho.

---