Wechaty é um SDK (kit de desenvolvimento de software) RPA (Robotic Process Automation) conversacional para criadores de chatbot. É bem projetado com uma API fácil de usar. Ele suporta todos os sistemas operacionais, incluindo Linux, OSX, Win32, Docker e muitos IMs (serviços de mensagens instantâneas), incluindo WeChat, WeCom, Whatsapp, Lark, Gitter, etc.
Como desenvolvedor, você pode usar o Wechaty para construir facilmente seu bot, gerenciar com eficácia o envio e recebimento de mensagens, a criação de salas e o envio de convites, entrar em contato com amigos e adicionar inteligência artificial entre os usuários e seu bot.
Se você é um iniciante no Wechaty, este projeto é o melhor ponto de partida para você. Você pode executá-lo em um Cloud IDE em algumas etapas ou em uma configuração local em sua máquina, conforme descrito nas seções abaixo.
Se você encontrar dificuldades ou tiver alguma dúvida, peça ajuda em nossa comunidade Discord em https://discord.gg/7q8NBZbQzt.
Aviso: a versão ativa atual do Wechaty é v1.x, que não é compatível com a maioria dos módulos v0.x.
[email protected]
- Para usar o Wechaty v0.x, visite a filial Wechaty Getting Started v0.x.dong
quando recebe uma mensagem ding
.Acima está um breve resumo da implantação do ding-dong-bot usando WeChat, WhatsApp e WeCom.
A maneira mais rápida de começar a usar o Wechaty é usar um IDE baseado em nuvem para executar o projeto Wechaty Getting Started. Você pode usar Gitpod ou Google Cloud Shell.
Se você é um iniciante, recomendamos o Gitpod.
Gitpod é uma plataforma online e de código aberto para ambientes de desenvolvimento automatizados e prontos para codificar. Você pode clicar no botão abaixo para acessar uma configuração completa do projeto Wechaty Getting Started ding-dong BOT no gitpod. Se você nunca usou o gitpod antes, será necessário fazer login usando sua conta do gitHub.
Você pode aprender mais sobre o Gitpod ❤️ Wechaty em nosso blog: Primeiros passos sem sair do navegador: Wechaty ❤️ Gitpod, @huan, 06 de fevereiro de 2021
O Google Cloud Shell é um ambiente on-line de desenvolvimento e operações acessível em qualquer lugar com seu navegador. Você pode executar este projeto no Google Cloud Shell clicando no botão abaixo.
Gerado via open-in-cloud-shell
Depois de abrir o editor do Google Cloud Shell, deverá haver um tutorial aberto no painel direito que você pode seguir para saber mais sobre o Wechaty.
Saiba mais sobre como executar este projeto no Google Cloud Shell em nosso blog: Tutoriais do Google Cloud Shell para Wechaty, @huan, 20 de fevereiro de 2021
Para executar este projeto em sua máquina local, você precisa:
Tenha o Node.js v16+ instalado em sua máquina. Você pode executar o comando node -v
no terminal para verificar se o Node.js
está instalado. Se você tiver, poderá ver a versão impressa no terminal como v16.13.0
. Sua versão pode ser diferente da v16.13.0
. Caso não esteja instalado ou sua versão seja inferior a 16, você precisa instalar a versão mais recente seguindo os links abaixo:
Node.js para outras plataformas pode ser encontrado em https://nodejs.org/en/download/package-manager/
Tenha o Wechaty Puppet Service TOKEN se quiser usar protocolos RPA diferentes da Web
Você precisa clonar este repositório em sua máquina local e depois mudar para o diretório wechaty-getting-started
executando os comandos abaixo.
git clone https://github.com/wechaty/getting-started.git
cd getting-started
Você precisa instalar dependências executando o comando abaixo.
npm install
Você pode usar export
para definir variáveis de ambiente no Linux e usar set
no Windows. Se você encontrar erros ao executar este comando, verifique as dicas de solução de problemas na etapa 4.
export WECHATY_LOG=verbose
export WECHATY_PUPPET=wechaty-puppet-wechat
npm start
# the above is equals to the below command:
# npx ts-node examples/ding-dong-bot.ts
set WECHATY_LOG=verbose
set WECHATY_PUPPET=wechaty-puppet-wechat
npm start
# the above is equals to the below command:
# npx ts-node examples/ding-dong-bot.ts
Está tudo pronto!
Se você tiver problemas ao seguir as etapas acima, tente as opções abaixo. Você também pode fazer perguntas em nossa sala de bate-papo do gitter.
Você também pode precisar do windows-build-tool se estiver usando o Windows:
npm install windows-build-tools
Em nosso exemplo de introdução, o BOT ding-dong usa wechaty-puppet-wechat4u quando WECHATY_PUPPET
não está definido, o que é apenas para conveniência do novato.
Por padrão, Wechaty usará o Puppet Service para fazer login em seu bot. Você pode usar outro provedor de fantoches, como o protocolo Whatsapp Web (wechaty-puppet-whatsapp).
Se você quiser usar um provedor Wechaty Puppet para um protocolo diferente, será necessário especificar um nome de provedor de serviços fantoche (igual ao nome NPM) definindo a variável de ambiente WECHATY_PUPPET
.
Graças às grandes contribuições da nossa comunidade, existem muitos Wechaty Puppets que podem ser usados pelo Wechaty. Eles nos ajudaram a usar protocolos como Web, Pad, Mac e Windows.
Protocolo | NPM |
---|---|
Serviço de fantoches | wechaty-puppet-service |
Whatsapp Web | wechaty-puppet-whatsapp |
WebChat | wechaty-puppet-wechat |
Painel WeChat | wechaty-puppet-padlocal |
Visite nosso site para saber mais sobre os provedores de serviços de fantoches Wechaty
Por exemplo, se quiser usar o fantoche padlocal
, você deve definir WECHATY_PUPPET=wechaty-puppet-padlocal
antes de executar npm start
. Você também precisa de um TOKEN para wechaty-puppet-padlocal
que precisa ser definido como a variável de ambiente WECHATY_PUPPET_PADLOCAL_TOKEN
. Você pode solicitar o PadLocal TOKEN aqui. Os trechos de código abaixo ilustram o que foi descrito acima no Linux/MacOS e no Windows.
export WECHATY_PUPPET=wechaty-puppet-padlocal
export WECHATY_PUPPET_PADLOCAL_TOKEN= ' puppet_padlocal_your-token-here '
npm start
set WECHATY_PUPPET=wechaty-puppet-padlocal
set WECHATY_PUPPET_PADLOCAL_TOKEN= ' puppet_padlocal_your-token-here '
npm start
Saiba mais sobre como instalar o Wechaty no Windows nesta postagem do blog.
Acima está um vídeo tutorial de 10 minutos. Ele está usando a versão 0.14 ou versões anteriores do Wechaty, portanto também está desatualizado. É uma boa maneira de começar se você é novo no Wechaty.
Nota: Antes de tentar mais exemplos, certifique-se de ter experimentado o projeto de introdução wechaty neste repositório.
https://github.com/wechaty/docker-wechaty-getting-started
https://github.com/wechaty/heroku-wechaty-getting-started
https://wechaty.github.io
A conta WeChat registrada após 2017 não poderá fazer login via Web API. Saiba mais sobre isso em wechaty/wechaty#872
Solução: você pode usar protocolos de suporte Wechaty diferentes da API da Web, como pad. Saiba mais em wechaty/wechaty#1296
Puppet
em WechatyO termo Puppet em Wechaty é uma classe abstrata para implementação de plugins de protocolo. Os plugins são os componentes que ajudam o Wechaty a controlar o Wechat e é por isso que o chamamos de fantoche.
Os plug-ins são chamados de PuppetXXX
, por exemplo, PuppetWeChat está usando o google puppeteer para controlar a API da Web WeChat por meio de um navegador Chrome, PuppetPadchat usa o protocolo WebSocket para se conectar a um servidor de protocolo para controlar o programa iPad Wechat. Para mais detalhes, você pode acessar o Puppet no wiki.
Saiba mais sobre o Wechaty Puppet em nossa documentação em Wechaty Puppet
Adicione exemplos de CQRS Wechaty.
Filial: v1.11: versão v1.11 do Wechaty.
Usando o Google Cloud Shell para uma configuração rápida!
Usando Gitpod para uma configuração rápida!
Versão inicial
@wechaty/contribuidores