getting started
1.0.0
Wechaty는 챗봇 제작자를 위한 대화형 RPA(Robotic Process Automation) SDK(소프트웨어 개발 키트)입니다. 사용하기 쉬운 API로 잘 설계되었습니다. Linux, OSX, Win32, Docker를 포함한 모든 운영 체제와 WeChat, WeCom, Whatsapp, Lark, Gitter 등을 포함한 다양한 IM(인스턴트 메시징 서비스)을 지원합니다.
개발자는 Wechaty를 사용하여 쉽게 봇을 구축하고, 메시지 보내기 및 받기, 방 생성 및 초대장 보내기, 친구에게 연락하기, 사용자와 봇 사이에 인공 지능을 즐겁게 추가하는 등을 효과적으로 관리할 수 있습니다.
Wechaty를 처음 사용하는 분이라면 이 프로젝트가 최고의 출발점이 될 것입니다. 아래 섹션에 설명된 대로 Cloud IDE에서 몇 단계를 거쳐 실행하거나 컴퓨터의 로컬 설정에서 실행할 수 있습니다.
어려움이 있거나 질문이 있는 경우 Discord 커뮤니티(https://discord.gg/7q8NBZbQzt)에 도움을 요청하실 수 있습니다.
참고: Wechaty의 현재 활성 버전은 v1.x이며 대부분의 v0.x 모듈과 호환되지 않습니다.
[email protected] - Wechaty v0.x를 사용하려면 Wechaty 시작하기 v0.x 지점을 방문하세요.ding 메시지를 받으면 dong 메시지로 응답합니다.
위는 WeChat, WhatsApp 및 WeCom을 사용하여 ding-dong-bot을 배포하는 간단한 실행 과정입니다.
Wechaty를 시작하는 가장 빠른 방법은 클라우드 기반 IDE를 사용하여 Wechaty 시작하기 프로젝트를 실행하는 것입니다. Gitpod 또는 Google Cloud Shell을 사용할 수 있습니다.
완전 초보자라면 Gitpod를 추천합니다.
Gitpod는 자동화되고 바로 코딩 가능한 개발 환경을 위한 온라인 오픈 소스 플랫폼입니다. 아래 버튼을 클릭하면 gitpod에서 Wechaty 시작하기 ding-dong BOT 프로젝트의 전체 설정에 액세스할 수 있습니다. 이전에 gitpod를 사용한 적이 없다면 gitHub 계정을 사용하여 로그인해야 합니다.
블로그에서 Gitpod ❤️ Wechaty에 대해 자세히 알아볼 수 있습니다. 브라우저를 떠나지 않고 시작하기: Wechaty ❤️ Gitpod, @huan, 2021년 2월 6일
Google Cloud Shell은 브라우저를 통해 어디서나 액세스할 수 있는 온라인 개발 및 운영 환경입니다. 아래 버튼을 클릭하면 Google Cloud Shell에서 이 프로젝트를 실행할 수 있습니다.
open-in-cloud-shell을 통해 생성됨
Google Cloud Shell 편집기를 열면 오른쪽 패널에 Wechaty에 대해 자세히 알아볼 수 있는 공개 튜토리얼이 있습니다.
블로그(2021년 2월 20일 @huan Wechaty용 Google Cloud Shell 튜토리얼)에서 Google Cloud Shell에서 이 프로젝트를 실행하는 방법에 대해 자세히 알아보세요.
로컬 컴퓨터에서 이 프로젝트를 실행하려면 다음을 수행해야 합니다.
컴퓨터에 Node.js v16+를 설치하세요. 터미널에서 node -v 명령을 실행하여 Node.js 설치되어 있는지 확인할 수 있습니다. 가지고 있다면 v16.13.0 과 같이 터미널에 인쇄된 버전을 볼 수 있을 것입니다. 귀하의 버전은 v16.13.0 과 다를 수 있습니다. 설치되어 있지 않거나 버전이 16 미만인 경우 아래 링크를 따라 최신 버전을 설치해야 합니다.
다른 플랫폼용 Node.js는 https://nodejs.org/en/download/package-manager/에서 찾을 수 있습니다.
웹 이외의 RPA 프로토콜을 사용하려면 Wechaty Puppet Service TOKEN을 보유하세요.
이 저장소를 로컬 머신에 복제한 후 아래 명령을 실행하여 wechaty-getting-started 디렉터리로 전환해야 합니다.
git clone https://github.com/wechaty/getting-started.git
cd getting-started아래 명령을 실행하여 종속성을 설치해야 합니다.
npm install export 사용하여 Linux에서 환경 변수를 설정할 수 있고 Windows에서는 set 사용할 수 있습니다. 이 명령을 실행하는 동안 오류가 발생하면 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모든 준비가 완료되었습니다!
위 단계를 수행하는 동안 문제가 발생하면 아래 옵션을 시도해 보세요. Gitter 채팅방에 질문하실 수도 있습니다.
Windows를 사용하는 경우 windows-build-tool이 필요할 수도 있습니다.
npm install windows-build-tools 시작하기 예시에서 ding-dong BOT는 WECHATY_PUPPET 설정되지 않은 경우 wechaty-puppet-wechat4u를 사용합니다. 이는 단지 신규 사용자의 편의를 위한 것입니다.
기본적으로 Wechaty는 봇에 로그인하기 위해 Puppet 서비스를 사용합니다. Whatsapp 웹 프로토콜(wechaty-puppet-whatsapp)과 같은 다른 Puppet 공급자를 사용할 수 있습니다.
다른 프로토콜에 Wechaty Puppet 공급자를 사용하려면 WECHATY_PUPPET 환경 변수를 설정하여 Puppet 서비스 공급자 이름(NPM 이름과 동일)을 지정해야 합니다.
커뮤니티의 큰 기여 덕분에 Wechaty에서 사용할 수 있는 Wechaty Puppet이 많이 생겼습니다. 그들은 우리가 웹, 패드, Mac, Windows와 같은 프로토콜을 사용하는 데 도움을 주었습니다.
| 규약 | NPM |
|---|---|
| 인형극 서비스 | wechaty-puppet-service |
| Whatsapp 웹 | wechaty-puppet-whatsapp |
| 위챗 웹 | wechaty-puppet-wechat |
| 위챗 패드 | wechaty-puppet-padlocal |
Wechaty Puppet 서비스 제공업체에 대해 자세히 알아보려면 당사 웹사이트를 방문하세요.
예를 들어, padlocal puppet을 사용하려면 npm start 실행하기 전에 WECHATY_PUPPET=wechaty-puppet-padlocal 설정해야 합니다. 또한 WECHATY_PUPPET_PADLOCAL_TOKEN 환경 변수로 설정해야 하는 wechaty-puppet-padlocal 에 대한 TOKEN이 필요합니다. 여기에서 PadLocal TOKEN을 신청할 수 있습니다. 아래 코드 조각은 Linux/MacOS 및 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이 블로그 게시물에서 Windows에 Wechaty를 설치하는 방법에 대해 자세히 알아보세요.
위에는 10분짜리 비디오 튜토리얼이 있습니다. 버전 0.14 이하의 Wechaty 버전을 사용하고 있으므로 구식이기도 합니다. Wechaty를 처음 사용하는 경우 시작하는 좋은 방법입니다.
참고: 더 많은 예제를 시도하기 전에 이 저장소에서 wechaty 시작하기 프로젝트를 시도했는지 확인하세요.
https://github.com/wechaty/docker-wechaty-getting-started
https://github.com/wechaty/heroku-wechaty-getting-started
https://wechaty.github.io
2017년 이후 등록된 WeChat 계정은 Web API를 통해 로그인할 수 없습니다. wechaty/wechaty#872에서 자세히 알아보세요.
해결 방법: 패드와 같은 Web API 이외의 Wechaty 지원 프로토콜을 사용할 수 있습니다. wechaty/wechaty#1296에서 자세히 알아보세요.
Puppet 란 무엇입니까?Wechaty에서 Puppet이라는 용어는 프로토콜 플러그인을 구현하기 위한 추상 클래스입니다. 플러그인은 Wechaty가 Wechat을 제어하는 데 도움이 되는 구성 요소이며 이것이 바로 우리가 이를 꼭두각시라고 부르는 이유입니다.
플러그인 이름은 PuppetXXX 입니다. 예를 들어 PuppetWeChat은 google puppeteer를 사용하여 Chrome 브라우저를 통해 WeChat 웹 API를 제어하고, PuppetPadchat은 WebSocket 프로토콜을 사용하여 iPad Wechat 프로그램을 제어하기 위해 프로토콜 서버에 연결합니다. 자세한 내용은 위키의 Puppet을 참조하세요.
Wechaty Puppet의 문서에서 Wechaty Puppet에 대해 자세히 알아보세요.
CQRS Wechaty 예제를 추가합니다.
분기: v1.11: Wechaty v1.11 릴리스.
빠른 설정을 위해 Google Cloud Shell을 사용하세요!
빠른 설정을 위해 Gitpod를 사용해보세요!
버전 초기화
@wechaty/기고자
