getting started
1.0.0
Wechaty ist ein Conversational RPA (Robotic Process Automation) SDK (Software Development Kit) für Chatbot-Hersteller. Es ist gut gestaltet und verfügt über eine benutzerfreundliche API. Es unterstützt alle Betriebssysteme, einschließlich Linux, OSX, Win32, Docker und viele IMs (Instant Messaging-Dienste), einschließlich WeChat, WeCom, WhatsApp, Lark, Gitter usw.
Als Entwickler können Sie mit Wechaty ganz einfach Ihren Bot erstellen, das Senden und Empfangen von Nachrichten, die Raumerstellung und das Versenden von Einladungen effektiv verwalten, Freunde kontaktieren und auf wunderbare Weise künstliche Intelligenz zwischen Benutzern und Ihrem Bot hinzufügen.
Wenn Sie ein absoluter Wechaty-Anfänger sind, ist dieses Projekt der beste Ausgangspunkt für Sie. Sie können es in wenigen Schritten auf einer Cloud-IDE oder in einem lokalen Setup auf Ihrem Computer ausführen, wie in den folgenden Abschnitten beschrieben.
Wenn Sie auf Schwierigkeiten stoßen oder Fragen haben, können Sie gerne in unserer Discord-Community unter https://discord.gg/7q8NBZbQzt um Hilfe bitten.
Hinweis: Die aktuell aktive Version von Wechaty ist v1.x, die mit den meisten v0.x-Modulen nicht kompatibel ist.
[email protected] – Um Wechaty v0.x zu verwenden, besuchen Sie bitte den Zweig Wechaty Getting Started v0.x.dong -Nachricht, wenn es eine ding -Nachricht empfängt.
Oben finden Sie einen kurzen Überblick über die Bereitstellung des Ding-Dong-Bots mithilfe von WeChat, WhatsApp und WeCom.
Der schnellste Weg, mit Wechaty zu beginnen, ist die Verwendung einer Cloud-basierten IDE zum Ausführen des Wechaty Getting Started Project. Sie können entweder Gitpod oder Google Cloud Shell verwenden.
Wenn Sie ein absoluter Anfänger sind, empfehlen wir Ihnen Gitpod.
Gitpod ist eine Online- und Open-Source-Plattform für automatisierte und programmierbare Entwicklungsumgebungen. Sie können auf die Schaltfläche unten klicken, um auf eine vollständige Einrichtung des Wechaty Getting Started Ding-Dong BOT-Projekts auf Gitpod zuzugreifen. Wenn Sie Gitpod noch nie zuvor verwendet haben, müssen Sie sich mit Ihrem GitHub-Konto anmelden.
Weitere Informationen zu Gitpod ❤️ Wechaty finden Sie in unserem Blog: Erste Schritte, ohne Ihren Browser zu verlassen: Wechaty ❤️ Gitpod, @huan, 06. Februar 2021
Google Cloud Shell ist eine Online-Entwicklungs- und Betriebsumgebung, auf die Sie überall mit Ihrem Browser zugreifen können. Sie können dieses Projekt in Google Cloud Shell ausführen, indem Sie auf die Schaltfläche unten klicken.
Generiert über Open-in-Cloud-Shell
Nach dem Öffnen des Google Cloud Shell-Editors sollte im rechten Bereich ein offenes Tutorial angezeigt werden, dem Sie folgen können, um mehr über Wechaty zu erfahren.
Erfahren Sie mehr über die Ausführung dieses Projekts auf Google Cloud Shell in unserem Blog: Google Cloud Shell Tutorials für Wechaty, @huan, 20. Februar 2021
Damit Sie dieses Projekt auf Ihrem lokalen Computer ausführen können, müssen Sie Folgendes tun:
Installieren Sie Node.js v16+ auf Ihrem Computer. Sie können den Befehl node -v auf dem Terminal ausführen, um zu überprüfen, ob Node.js installiert ist. Wenn Sie es haben, sollten Sie die auf dem Terminal ausgedruckte Version wie v16.13.0 sehen können. Ihre Version unterscheidet sich möglicherweise von v16.13.0 . Wenn es nicht installiert ist oder Ihre Version niedriger als 16 ist, müssen Sie die neueste Version installieren, indem Sie den folgenden Links folgen:
Node.js für andere Plattformen finden Sie unter https://nodejs.org/en/download/package-manager/
Besitzen Sie das Wechaty Puppet Service TOKEN, wenn Sie andere RPA-Protokolle als Web verwenden möchten
Sie müssen dieses Repository auf Ihren lokalen Computer klonen und dann in das Verzeichnis wechaty-getting-started wechseln, indem Sie die folgenden Befehle ausführen.
git clone https://github.com/wechaty/getting-started.git
cd getting-startedSie müssen Abhängigkeiten installieren, indem Sie den folgenden Befehl ausführen.
npm install Sie können export verwenden, um Umgebungsvariablen unter Linux festzulegen, und set unter Windows verwenden. Wenn beim Ausführen dieses Befehls Fehler auftreten, lesen Sie die Tipps zur Fehlerbehebung in Schritt 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.tsSie sind bereit!
Wenn beim Befolgen der oben genannten Schritte Probleme auftreten, probieren Sie die folgenden Optionen aus. Gerne können Sie auch Fragen in unserem Gitter-Chatroom stellen.
Möglicherweise benötigen Sie auch das Windows-Build-Tool, wenn Sie Windows verwenden:
npm install windows-build-tools In unserem Einstiegsbeispiel verwendet der Ding-Dong-BOT wechaty-puppet-wechat4u, wenn WECHATY_PUPPET nicht festgelegt ist, was nur der Bequemlichkeit für Einsteiger dient.
Standardmäßig verwendet Wechaty den Puppet-Dienst zum Anmelden Ihres Bots. Sie können andere Puppet-Anbieter wie das WhatsApp-Webprotokoll (wechaty-puppet-whatsapp) verwenden.
Wenn Sie einen Wechaty Puppet Provider für ein anderes Protokoll verwenden möchten, müssen Sie einen Puppet-Service-Provider-Namen (der mit dem NPM-Namen übereinstimmt) angeben, indem Sie die Umgebungsvariable WECHATY_PUPPET festlegen.
Dank der großartigen Beiträge unserer Community gibt es viele Wechaty-Puppen, die von Wechaty verwendet werden können. Sie haben uns geholfen, Protokolle wie Web, Pad, Mac und Windows zu verwenden.
| Protokoll | NPM |
|---|---|
| Puppenservice | wechaty-puppet-service |
| WhatsApp-Web | wechaty-puppet-whatsapp |
| WeChat-Web | wechaty-puppet-wechat |
| WeChat-Pad | wechaty-puppet-padlocal |
Besuchen Sie unsere Website, um mehr über die Wechaty Puppet Service Providers zu erfahren
Wenn Sie beispielsweise die padlocal Puppe verwenden möchten, sollten Sie WECHATY_PUPPET=wechaty-puppet-padlocal festlegen, bevor Sie npm start ausführen. Sie benötigen außerdem ein TOKEN für wechaty-puppet-padlocal , das Sie auf die Umgebungsvariable WECHATY_PUPPET_PADLOCAL_TOKEN setzen müssen. Sie können den PadLocal TOKEN hier beantragen. Die folgenden Codeausschnitte veranschaulichen, was oben unter Linux/MacOS und unter Windows beschrieben wurde.
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 startErfahren Sie in diesem Blogbeitrag mehr über die Installation von Wechaty unter Windows.
Oben finden Sie ein 10-minütiges Video-Tutorial. Es verwendet Version 0.14 oder ältere Versionen von Wechaty und ist daher ebenfalls veraltet. Es ist ein guter Anfang, wenn Sie neu bei Wechaty sind.
Hinweis: Bevor Sie sich an weiteren Beispielen versuchen, stellen Sie sicher, dass Sie das Projekt „wechaty Getting Started“ in diesem Repository ausprobiert haben.
https://github.com/wechaty/docker-wechaty-getting-started
https://github.com/wechaty/heroku-wechaty-getting-started
https://wechaty.github.io
Ein WeChat-Konto, das nach 2017 registriert wurde, kann sich nicht über die Web-API anmelden. Erfahren Sie mehr darüber unter wechaty/wechaty#872
Lösung: Sie können andere Wechaty-Unterstützungsprotokolle als die Web-API verwenden, z. B. Pad. Erfahren Sie mehr unter wechaty/wechaty#1296
Puppet in Wechaty?Der Begriff Puppet in Wechaty ist eine abstrakte Klasse zur Implementierung von Protokoll-Plugins. Die Plugins sind die Komponenten, die Wechaty dabei helfen, Wechat zu steuern, und deshalb nennen wir es Puppet.
Die Plugins heißen PuppetXXX . PuppetWeChat verwendet beispielsweise den Google Puppeteer, um die WeChat-Web-API über einen Chrome-Browser zu steuern. PuppetPadchat verwendet das WebSocket-Protokoll, um eine Verbindung mit einem Protokollserver zur Steuerung des iPad-Wechat-Programms herzustellen. Weitere Informationen finden Sie unter Puppet im Wiki.
Erfahren Sie mehr über Wechaty Puppet in unserer Dokumentation bei Wechaty Puppet
Fügen Sie CQRS Wechaty-Beispiele hinzu.
Zweig: v1.11: Veröffentlichung v1.11 von Wechaty.
Verwenden Sie Google Cloud Shell für eine schnelle Einrichtung!
Verwenden Sie Gitpod für eine schnelle Einrichtung!
Init-Version
@wechaty/contributors
