wa-automate-nodejs

项目介绍：wa-automate-nodejs

项目概述

wa-automate-nodejs 是一个功能强大的 NodeJS 库，专为控制 WhatsApp Web 提供高级 API。通过此库，用户可以轻松地将 WhatsApp 帐户转换为一个强大的 API 工具，实现自动化的信息交流和管理功能。

安装与更新

要开始使用 wa-automate-nodejs，首先需要安装这个库。运行以下命令可以安装最新版本并保持库的更新：

> npm i --save @open-wa/wa-automate@latest

使用方式

wa-automate-nodejs 支持多种使用方式，包括 CLI（命令行界面）和自定义设置。

CLI 使用

如果想要快速将 WhatsApp 帐户转换为 API，可以使用 CLI。通过以下命令可以获取更多 CLI 的使用信息：

> npx @open-wa/wa-automate --help

自定义设置

用户可以根据自己的需求对配置进行自定义设置。以下是一个简单的 JavaScript 示例：

const wa = require('@open-wa/wa-automate');

wa.create({
  sessionId: "COVID_HELPER",
  multiDevice: true,
  authTimeout: 60,
  blockCrashLogs: true,
  disableSpins: true,
  headless: true,
  hostNotificationLang: 'PT_BR',
  logConsole: false,
  popup: true,
  qrTimeout: 0,
}).then(client => start(client));

function start(client) {
  client.onMessage(async message => {
    if (message.body === 'Hi') {
      await client.sendText(message.from, '👋 Hello!');
    }
  });
}

执行 create() 函数后，@open-wa/wa-automate 将创建一个 WhatsApp Web 实例。如果尚未登录，将在终端输出二维码，扫描后即可开始使用。

多设备支持

当前，wa-automate-nodejs 正处于支持多设备的过渡阶段。一旦转型完成，缺省会开启多设备支持模式。现阶段，用户需要通过命令行标志 --multi-device 或自定义代码配置中的 multiDevice: true 来启用多设备支持。

主要功能

wa-automate-nodejs 提供了一系列有用的功能，包括但不限于：

接收信息：通过 onMessage 函数监听来信
发送文本消息：使用 sendText
获取联系人：通过 getContact 函数
获取聊天记录：使用 getAllChats
群组管理：包括获取群组、群组成员及管理参与者
发送多媒体：支持发送图片、音频、视频及文档等
实时位置监听：通过 onLiveLocation 函数
群組变化监听：通过 onParticipantsChanged 函数

这些功能让用户能够高效地管理和自动化 WhatsApp 中的操作。

运行演示

用户可以克隆项目仓库，使用 TypeScript 或 ts-node 运行示例演示。以下是示例命令：

> git clone https://github.com/open-wa/wa-automate-nodejs.git
> cd wa-automate-nodejs
> npm i
> npm install -g ts-node typescript
> cd demo
> ts-node index.ts