getting started

Wechaty เริ่มต้นใช้งาน

เกี่ยวกับ Wechaty

Wechaty คือ SDK (ชุดพัฒนาซอฟต์แวร์) RPA (Robotic Process Automation) แบบสนทนาสำหรับผู้สร้าง Chatbot ได้รับการออกแบบมาอย่างดีพร้อม API ที่ใช้งานง่าย รองรับระบบปฏิบัติการทั้งหมดรวมถึง Linux, OSX, Win32, Docker และ IM จำนวนมาก (บริการส่งข้อความโต้ตอบแบบทันที) รวมถึง WeChat, WeCom, Whatsapp, Lark, Gitter เป็นต้น

ในฐานะนักพัฒนา คุณสามารถใช้ Wechaty เพื่อสร้างบอทของคุณได้อย่างง่ายดาย จัดการการส่งและรับข้อความอย่างมีประสิทธิภาพ การสร้างห้องและการส่งคำเชิญ ติดต่อเพื่อน และเพิ่มปัญญาประดิษฐ์ระหว่างผู้ใช้และบอทของคุณได้อย่างน่ายินดี

เกี่ยวกับโครงการเริ่มต้นใช้งาน Wechaty

หากคุณเป็นผู้เริ่มต้นใช้งาน Wechaty โปรเจ็กต์นี้คือจุดเริ่มต้นที่ดีที่สุดสำหรับคุณ คุณสามารถรันบน Cloud IDE ได้ในไม่กี่ขั้นตอนหรือในการตั้งค่าภายในเครื่องของคุณตามที่อธิบายไว้ในส่วนด้านล่าง

หากคุณประสบปัญหาหรือมีคำถามใดๆ คุณสามารถขอความช่วยเหลือได้ในชุมชน Discord ของเราที่ https://discord.gg/7q8NBZbQzt

หมายเหตุ: Wechaty เวอร์ชันที่ใช้งานอยู่ในปัจจุบันคือ v1.x ซึ่งเข้ากันไม่ได้กับโมดูล v0.x ส่วนใหญ่

• [email protected] - หากต้องการใช้ Wechaty v0.x โปรดไปที่สาขา Wechaty Getting Started v0.x

คุณสมบัติของโครงการเริ่มต้นใช้งาน Wechaty

1. มันใช้งานได้ทันทีบน Linux, Mac หรือ Windows
2. รองรับหุ่นเชิดทั้งหมดเช่น Web, Pad, Windows และ Mac
3. มันจะตอบกลับด้วยข้อความ dong เมื่อได้รับข้อความ ding

วิดีโอแนะนำการเริ่มต้นใช้งาน Wechaty

ข้างต้นเป็นการอธิบายสั้นๆ ของการปรับใช้ ding-dong-bot โดยใช้ WeChat, WhatsApp และ WeCom

การรันโครงการเริ่มต้นใช้งาน Wechaty บน IDE บนคลาวด์

วิธีที่เร็วที่สุดในการเริ่มต้นใช้งาน Wechaty คือการใช้ IDE บนคลาวด์เพื่อรัน Wechaty Getting Started Project คุณสามารถใช้ Gitpod หรือ Google Cloud Shell ได้

หากคุณเป็นมือใหม่ เราขอแนะนำ Gitpod

ใช้ Gitpod ❤️ Wechaty

Gitpod เป็นแพลตฟอร์มออนไลน์และโอเพ่นซอร์สสำหรับสภาพแวดล้อมการพัฒนาแบบอัตโนมัติและพร้อมเขียนโค้ด คุณสามารถคลิกปุ่มด้านล่างเพื่อเข้าถึงการตั้งค่าทั้งหมดของโครงการ Wechaty Getting Started ding-dong BOT บน gitpod หากคุณไม่เคยใช้ gitpod มาก่อน คุณจะต้องเข้าสู่ระบบโดยใช้บัญชี gitHub ของคุณ

คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับ Gitpod ❤️ Wechaty ได้จากบล็อกของเรา: เริ่มต้นใช้งานโดยไม่ต้องออกจากเบราว์เซอร์: Wechaty ❤️ Gitpod, @huan, 06 ก.พ. 2021

การใช้ Google Cloud Shell

Google Cloud Shell คือสภาพแวดล้อมการพัฒนาและการดำเนินงานออนไลน์ที่สามารถเข้าถึงได้จากทุกที่ด้วยเบราว์เซอร์ของคุณ คุณเรียกใช้โปรเจ็กต์นี้บน Google Cloud Shell ได้โดยคลิกปุ่มด้านล่าง

สร้างผ่าน open-in-cloud-shell

หลังจากเปิดตัวแก้ไข Google Cloud Shell แล้ว ควรมีบทช่วยสอนแบบเปิดในแผงด้านขวาซึ่งคุณสามารถติดตามเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับ Wechaty

เรียนรู้เพิ่มเติมเกี่ยวกับการดำเนินโปรเจ็กต์นี้บน Google Cloud Shell จากบล็อกของเรา: บทแนะนำ Google Cloud Shell สำหรับ Wechaty, @huan, 20 ก.พ. 2021

กำลังรันโปรเจ็กต์เริ่มต้นใช้งาน Wechaty บนเครื่องของคุณ

ข้อกำหนดเบื้องต้น

หากต้องการรันโปรเจ็กต์นี้บนเครื่องภายใน คุณจะต้อง:

1. ติดตั้ง Node.js v16+ บนเครื่องของคุณ คุณสามารถรันคำสั่ง node -v บนเทอร์มินัลเพื่อตรวจสอบว่าคุณได้ติดตั้ง Node.js หรือไม่ หากคุณมี คุณควรจะเห็นเวอร์ชันที่พิมพ์บนเทอร์มินัลเช่น v16.13.0 เวอร์ชันของคุณอาจแตกต่างจาก v16.13.0 หากไม่ได้ติดตั้งหรือเวอร์ชันของคุณต่ำกว่า 16 คุณจะต้องติดตั้งเวอร์ชันล่าสุดโดยไปที่ลิงก์ด้านล่าง:

   • หน้าต่าง
   • ลินุกซ์ (เดเบียน/อูบุนตู)
   • ระบบปฏิบัติการ macOS

   Node.js สำหรับแพลตฟอร์มอื่นๆ สามารถพบได้ที่ https://nodejs.org/en/download/package-manager/

2. มี Wechaty Puppet Service TOKEN หากคุณต้องการใช้โปรโตคอล RPA อื่นที่ไม่ใช่เว็บ

ขั้นตอนที่ 1: โคลนพื้นที่เก็บข้อมูลนี้

คุณต้องโคลนพื้นที่เก็บข้อมูลนี้ไปยังเครื่องภายในของคุณ จากนั้นสลับไปยังไดเร็กทอรี wechaty-getting-started โดยเรียกใช้คำสั่งด้านล่าง

git clone https://github.com/wechaty/getting-started.git
cd getting-started

ขั้นตอนที่ 2: ติดตั้งการพึ่งพา

คุณต้องติดตั้งการพึ่งพาโดยการรันคำสั่งด้านล่าง

npm install

ขั้นตอนที่ 3: เรียกใช้บอท

คุณสามารถใช้ export เพื่อตั้งค่าตัวแปรสภาพแวดล้อมใน Linux และใช้ set ใน Windows หากคุณพบข้อผิดพลาดขณะเรียกใช้คำสั่งนี้ ให้ตรวจสอบเคล็ดลับการแก้ปัญหาในขั้นตอนที่ 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

คุณพร้อมแล้ว!

ขั้นตอนที่ 4: การแก้ไขปัญหา

หากคุณประสบปัญหาขณะทำตามขั้นตอนข้างต้น ให้ลองใช้ตัวเลือกด้านล่าง คุณสามารถถามคำถามได้ในห้องสนทนา Gitter ของเรา

1. คุณอาจต้องใช้ windows-build-tool หากคุณใช้ windows:

   npm install windows-build-tools

การทำงานกับหุ่นต่างๆ

ในตัวอย่างการเริ่มต้นของเรา ding-dong BOT จะใช้ wechaty-puppet-wechat4u เมื่อไม่ได้ตั้งค่า WECHATY_PUPPET ซึ่งมีไว้เพื่อความสะดวกของผู้มาใหม่เท่านั้น

ตามค่าเริ่มต้น Wechaty จะใช้บริการ Puppet เพื่อเข้าสู่ระบบบอทของคุณ คุณสามารถใช้ผู้ให้บริการหุ่นเชิดอื่น ๆ เช่น Whatsapp Web protocol (wechaty-puppet-whatsapp)

หากคุณต้องการใช้ Wechaty Puppet Provider สำหรับโปรโตคอลอื่น คุณจะต้องระบุชื่อผู้ให้บริการหุ่นกระบอก (เหมือนกับชื่อ NPM) โดยการตั้งค่าตัวแปรสภาพแวดล้อม WECHATY_PUPPET

ขอขอบคุณการสนับสนุนที่ยอดเยี่ยมจากชุมชนของเรา ทำให้มี Wechaty Puppets มากมายที่ Wechaty สามารถใช้ได้ พวกเขาช่วยเราใช้โปรโตคอลเช่น Web, Pad, Mac และ Windows

หุ่น Wechaty

โปรโตคอล	เอ็นพีเอ็ม
บริการหุ่นเชิด	wechaty-puppet-service
เว็บ Whatsapp	wechaty-puppet-whatsapp
เว็บวีแชท	wechaty-puppet-wechat
วีแชทแพด	wechaty-puppet-padlocal

เยี่ยมชมเว็บไซต์ของเราเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับผู้ให้บริการ Wechaty Puppet

ตัวอย่างเช่น หากคุณต้องการใช้หุ่น padlocal คุณควรตั้งค่า WECHATY_PUPPET=wechaty-puppet-padlocal ก่อนที่จะรัน npm start คุณต้องมี TOKEN สำหรับ wechaty-puppet-padlocal ซึ่งคุณต้องตั้งค่าเป็นตัวแปรสภาพแวดล้อม WECHATY_PUPPET_PADLOCAL_TOKEN คุณสามารถสมัคร PadLocal TOKEN ได้จากที่นี่ ข้อมูลโค้ดด้านล่างนี้แสดงให้เห็นถึงสิ่งที่อธิบายไว้ข้างต้นบน Linux/ MacOS และบน Windows

บนลินุกซ์ / macOS

 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

เรียนรู้เพิ่มเติมเกี่ยวกับการติดตั้ง Wechaty บน windows จากโพสต์บนบล็อกนี้

บทช่วยสอนขั้นสูง

1. บทช่วยสอน Wechaty

ด้านบนนี้เป็นวิดีโอสอนความยาว 10 นาที กำลังใช้ Wechaty เวอร์ชัน 0.14 หรือเก่ากว่า ดังนั้นจึงล้าสมัยเช่นกัน นี่เป็นวิธีเริ่มต้นที่ดีหากคุณยังใหม่กับ Wechaty

2. ตัวอย่างเพิ่มเติม

หมายเหตุ: ก่อนที่คุณจะลองตัวอย่างเพิ่มเติม ตรวจสอบให้แน่ใจว่าคุณได้ลองใช้โปรเจ็กต์เริ่มต้นใช้งาน wechaty ในที่เก็บนี้แล้ว

• ไดเรกทอรีตัวอย่าง Wechaty อย่างเป็นทางการ

การอ้างอิง API

1. เอกสาร API อย่างเป็นทางการ: https://wechaty.js.org/docs/api

แหล่งข้อมูลเพิ่มเติม

1. เริ่มต้นใช้งาน Docker Wechaty

https://github.com/wechaty/docker-wechaty-getting-started

2. Heroku Wechaty เริ่มต้นใช้งาน

https://github.com/wechaty/heroku-wechaty-getting-started

3. บ้าน Wechaty

https://wechaty.github.io

คำถามที่พบบ่อย

1. ฉันไม่สามารถเข้าสู่ระบบด้วยบัญชี Wechat ของฉันได้

บัญชี WeChat ที่ลงทะเบียนหลังปี 2017 จะไม่สามารถเข้าสู่ระบบผ่าน Web API ได้ เรียนรู้เพิ่มเติมเกี่ยวกับเรื่องนี้ได้ที่ wechaty/wechaty#872

วิธีแก้ไข: คุณสามารถใช้โปรโตคอลสนับสนุน Wechaty อื่นที่ไม่ใช่ Web API ได้ เช่น แพด เรียนรู้เพิ่มเติมที่ wechaty/wechaty#1296

2. Puppet ใน Wechaty คืออะไร

คำว่า Puppet ใน Wechaty เป็นคลาสนามธรรมสำหรับการนำปลั๊กอินโปรโตคอลไปใช้ ปลั๊กอินเป็นส่วนประกอบที่ช่วยให้ Wechaty ควบคุม Wechat และนั่นคือเหตุผลว่าทำไมเราถึงเรียกมันว่าหุ่นเชิด

ปลั๊กอินมีชื่อว่า PuppetXXX เช่น PuppetWeChat ใช้ Google puppeteer เพื่อควบคุม WeChat Web API ผ่านเบราว์เซอร์ Chrome PuppetPadchat ใช้โปรโตคอล WebSocket เพื่อเชื่อมต่อกับ Protocol Server สำหรับควบคุมโปรแกรม Wechat ของ iPad สำหรับรายละเอียดเพิ่มเติม คุณสามารถไปที่ Puppet ในวิกิ

เรียนรู้เพิ่มเติมเกี่ยวกับ Wechaty Puppet จากเอกสารของเราที่ Wechaty Puppet

Wechaty เริ่มต้นใช้งานในหลายภาษา

• TypeScript Wechaty เริ่มต้นใช้งาน
• Python Wechaty เริ่มต้นใช้งาน
• ไปที่ Wechaty เริ่มต้นใช้งาน
• Java Wechaty เริ่มต้นใช้งาน
• Scala Wechaty เริ่มต้นใช้งาน
• PHP Wechaty เริ่มต้นใช้งาน
• .NET(C#) เริ่มต้นใช้งาน Wechaty

ประวัติศาสตร์

หลัก v1.18 (14 มี.ค. 2565)

เพิ่มตัวอย่าง CQRS Wechaty

เวอร์ชัน 1.11 (30 ต.ค. 2564)

สาขา: v1.11: ปล่อย v1.11 ของ Wechaty

1. v0.13: เปิดใช้งานการสนับสนุน ESM (ES Module) (chatie/tsconfig#16)

เวอร์ชัน 0.8 (20 ก.พ. 2564)

ใช้ Google Cloud Shell เพื่อการตั้งค่าอย่างรวดเร็ว!

เวอร์ชัน 0.6 (11 กุมภาพันธ์ 2564)

ใช้ Gitpod เพื่อการตั้งค่าอย่างรวดเร็ว!

v0.0.1 (12 ม.ค. 2017)

เวอร์ชันเริ่มต้น

ผู้ร่วมให้ข้อมูล

ผู้ดูแล

@wechaty/ผู้มีส่วนร่วม

ลิขสิทธิ์และใบอนุญาต

• รหัสและเอกสาร © 2018-ปัจจุบันคือ Huan และ Wechaty Contributors
• รหัสที่เผยแพร่ภายใต้ลิขสิทธิ์ Apache-2.0
• เอกสารเผยแพร่ภายใต้ครีเอทีฟคอมมอนส์