getting started
1.0.0
Wechaty adalah SDK (Software Development Kit) RPA (Robotic Process Automation) Percakapan untuk Pembuat Chatbot. Ini dirancang dengan baik dengan API yang mudah digunakan. Mendukung semua sistem operasi termasuk Linux, OSX, Win32, Docker, dan banyak IM (layanan Pesan Instan) termasuk WeChat, WeCom, Whatsapp, Lark, Gitter, dll.
Sebagai pengembang, Anda dapat menggunakan Wechaty untuk membuat bot Anda dengan mudah, mengelola pengiriman dan penerimaan pesan secara efektif, pembuatan ruangan dan pengiriman undangan, menghubungi teman, dan menambahkan kecerdasan buatan antara pengguna dan bot Anda dengan menyenangkan.
Jika Anda benar-benar pemula di Wechaty, proyek ini adalah titik awal terbaik untuk Anda. Anda dapat menjalankannya di Cloud IDE dalam beberapa langkah atau pada penyiapan lokal di mesin Anda seperti yang dijelaskan pada bagian di bawah.
Jika Anda mengalami kesulitan atau memiliki pertanyaan, Anda dapat meminta bantuan di Komunitas Discord kami di https://discord.gg/7q8NBZbQzt.
Pemberitahuan: versi Wechaty yang aktif saat ini adalah v1.x yang tidak kompatibel dengan sebagian besar modul v0.x.
[email protected] - Untuk menggunakan Wechaty v0.x, silakan kunjungi cabang Wechaty Getting Started v0.x.dong ketika menerima pesan ding .
Di atas adalah penjelasan singkat tentang penerapan bot ding-dong menggunakan WeChat, WhatsApp, dan WeCom.
Cara tercepat untuk memulai Wechaty adalah dengan menggunakan IDE berbasis Cloud untuk menjalankan Proyek Memulai Wechaty. Anda dapat menggunakan Gitpod atau Google Cloud Shell.
Jika Anda benar-benar pemula, kami merekomendasikan Gitpod.
Gitpod adalah platform online dan sumber terbuka untuk lingkungan pengembangan otomatis dan siap dikodekan. Anda dapat mengklik tombol di bawah ini untuk mengakses pengaturan lengkap proyek BOT ding-dong Memulai Wechaty di gitpod. Jika Anda belum pernah menggunakan gitpod sebelumnya, Anda akan diminta login menggunakan akun gitHub Anda.
Anda dapat mempelajari lebih lanjut tentang Gitpod ❤️ Wechaty dari blog kami: Memulai Tanpa Meninggalkan Browser Anda: Wechaty ❤️ Gitpod, @huan, 06 Feb 2021
Google Cloud Shell adalah lingkungan pengembangan dan operasi online yang dapat diakses di mana saja melalui browser Anda. Anda dapat menjalankan proyek ini di Google Cloud Shell dengan mengklik tombol di bawah.
Dihasilkan melalui open-in-cloud-shell
Setelah membuka editor Google Cloud Shell, seharusnya ada tutorial terbuka di panel kanan yang dapat Anda ikuti untuk mempelajari lebih lanjut tentang Wechaty.
Pelajari lebih lanjut cara menjalankan proyek ini di Google Cloud Shell dari blog kami: Tutorial Google Cloud Shell untuk Wechaty, @huan, 20 Feb 2021
Agar Anda dapat menjalankan proyek ini di mesin lokal, Anda perlu:
Sudah menginstal Node.js v16+ di mesin Anda. Anda dapat menjalankan perintah node -v di terminal untuk memeriksa apakah Anda telah menginstal Node.js Jika Anda memilikinya, Anda seharusnya dapat melihat versi yang tercetak di terminal seperti v16.13.0 . Versi Anda mungkin berbeda dari v16.13.0 . Jika belum diinstal atau versi Anda di bawah 16, Anda perlu menginstal versi terbaru dengan mengikuti tautan di bawah ini:
Node.js untuk platform lain dapat ditemukan di https://nodejs.org/en/download/package-manager/
Miliki TOKEN Layanan Wayang Wechaty jika Anda ingin menggunakan protokol RPA selain Web
Anda perlu mengkloning repositori ini ke mesin lokal Anda dan kemudian beralih ke direktori wechaty-getting-started dengan menjalankan perintah di bawah ini.
git clone https://github.com/wechaty/getting-started.git
cd getting-startedAnda perlu menginstal dependensi dengan menjalankan perintah di bawah ini.
npm install Anda dapat menggunakan export untuk mengatur variabel lingkungan di Linux, dan menggunakan set di Windows. Jika Anda mengalami kesalahan saat menjalankan perintah ini, periksa tips pemecahan masalah di langkah 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.tsAnda sudah siap!
Jika Anda mengalami masalah saat mengikuti langkah-langkah di atas, coba opsi di bawah. Anda juga dipersilakan untuk mengajukan pertanyaan di ruang obrolan gitter kami.
Anda mungkin juga memerlukan windows-build-tool jika Anda menggunakan windows:
npm install windows-build-tools Dalam contoh awal kita, BOT ding-dong menggunakan wechaty-puppet-wechat4u ketika WECHATY_PUPPET tidak disetel, yang hanya untuk kenyamanan pendatang baru.
Secara default, Wechaty akan menggunakan Layanan Boneka untuk login bot Anda. Anda dapat menggunakan Penyedia Boneka lain seperti protokol Web Whatsapp (wechaty-puppet-whatsapp).
Jika Anda ingin menggunakan Penyedia Boneka Wechaty untuk protokol yang berbeda, maka Anda perlu menentukan nama penyedia layanan boneka (sama dengan nama NPM-nya) dengan mengatur variabel lingkungan WECHATY_PUPPET .
Berkat kontribusi besar dari komunitas kami, ada banyak Boneka Wechaty yang dapat digunakan oleh Wechaty. Mereka telah membantu kami menggunakan protokol seperti Web, Pad, Mac, dan Windows.
| Protokol | NPM |
|---|---|
| Layanan Boneka | wechaty-puppet-service |
| Web Whatsapp | wechaty-puppet-whatsapp |
| Web WeChat | wechaty-puppet-wechat |
| WeChat Pad | wechaty-puppet-padlocal |
Kunjungi website kami untuk mempelajari lebih lanjut tentang Penyedia Layanan Wayang Wechaty
Misalnya, jika Anda ingin menggunakan boneka padlocal , Anda harus menyetel WECHATY_PUPPET=wechaty-puppet-padlocal sebelum menjalankan npm start . Anda juga memerlukan TOKEN untuk wechaty-puppet-padlocal yang perlu Anda setel ke variabel lingkungan WECHATY_PUPPET_PADLOCAL_TOKEN . Anda dapat mengajukan permohonan PadLocal TOKEN dari sini. Cuplikan kode di bawah ini menggambarkan apa yang telah dijelaskan di atas pada Linux/MacOS dan 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 startPelajari lebih lanjut tentang menginstal Wechaty di windows dari postingan blog ini.
Di atas adalah video tutorial 10 menit. Ini menggunakan Wechaty versi 0.14 atau lebih lama oleh karena itu juga sudah ketinggalan zaman. Ini adalah cara yang baik untuk memulai jika Anda baru mengenal Wechaty.
Catatan: Sebelum Anda mencoba contoh lainnya, pastikan Anda telah mencoba proyek memulai wechaty di repositori ini.
https://github.com/wechaty/docker-wechaty-getting-started
https://github.com/wechaty/heroku-wechaty-getting-started
https://wechaty.github.io
Akun WeChat yang didaftarkan setelah tahun 2017 tidak akan dapat login melalui Web API. Pelajari lebih lanjut tentang itu di wechaty/wechaty#872
Solusi: Anda dapat menggunakan protokol dukungan Wechaty selain Web API, seperti pad. Pelajari lebih lanjut di wechaty/wechaty#1296
Puppet di WechatyIstilah Wayang di Wechaty adalah Kelas Abstrak untuk mengimplementasikan plugin protokol. Plugin adalah komponen yang membantu Wechaty mengendalikan Wechat dan itulah alasan mengapa kami menyebutnya boneka.
Plugin tersebut diberi nama PuppetXXX , misalnya PuppetWeChat menggunakan dalang google untuk mengontrol WeChat Web API melalui browser chrome, PuppetPadchat menggunakan protokol WebSocket untuk terhubung dengan Server Protokol untuk mengontrol program iPad Wechat. Untuk lebih jelasnya Anda dapat mengunjungi Wayang di wiki.
Pelajari lebih lanjut tentang Boneka Wechaty dari dokumentasi kami di Boneka Wechaty
Tambahkan contoh CQRS Wechaty.
Cabang: v1.11: rilis Wechaty v1.11.
Menggunakan Google Cloud Shell untuk penyiapan cepat!
Menggunakan Gitpod untuk pengaturan cepat!
Versi init
@wechaty/kontributor
