@acampagnaro/whatsapp-web.js 中文文档教程

Question

whatsapp-web.js

通过 WhatsApp Web 浏览器应用程序连接的 WhatsApp API 客户端

它使用 Puppeteer 运行 Whatsapp Web 的真实实例以避免被阻止。

注意：我不能保证您不会被阻止使用此方法，尽管它对我有用。 WhatsApp 不允许在其平台上使用机器人或非官方客户端，因此这不应被认为是完全安全的。

Installation

该模块现在在 npm 上可用！ npm i whatsapp-web.js

请注意，需要 Node v12+。

Example usage

const { Client } = require('whatsapp-web.js');

const client = new Client();

client.on('qr', (qr) => {
    // Generate and scan this code with your phone
    console.log('QR RECEIVED', qr);
});

client.on('ready', () => {
    console.log('Client is ready!');
});

client.on('message', msg => {
    if (msg.body == '!ping') {
        msg.reply('pong');
    }
});

client.initialize();

查看 example.js 以获得更多用例的另一个示例。

Remote Access

您还可以连接到任何以前存在的浏览器实例：

const client = new Client({ 
    puppeteer: {
        browserWSEndpoint: `ws://localhost:3000`
    }
});

Docker

//docs.browserless.io/docs/docker-quickstart.html

docker run \
  --rm \
  -p 3000:3000 \
  -e "MAX_CONCURRENT_SESSIONS=1" \
  browserless/chrome:latest

1）使用无浏览器安装浏览器：参考：https:

Remote Debugging

2）运行启用了 websocket 远程调试的浏览器：

chrome .exe --remote-debugging-port=9222

之后检查以下网页并检查 http://127.0.0.1:9220/json 并获取 webSocketDebuggerUrl

Supported features

Feature	Status
Send messages	✅
Receive messages	✅
Send media (images/audio/documents)	✅
Send media (video)	✅ (requires google chrome)
Send stickers	✅
Receive media (images/audio/video/documents)	✅
Send contact cards	✅
Send location	✅
Receive location	✅
Message replies	✅
Join groups by invite	✅
Get invite for group	✅
Modify group info (subject, description)	✅
Modify group settings (send messages, edit info)	✅
Add group participants	✅
Kick group participants	✅
Promote/demote group participants	✅
Mention users	✅
Mute/unmute chats	✅
Block/unblock contacts	✅
Get contact info	✅
Get profile pictures	✅
Set user status message	✅

缺少什么？ 提出问题并告诉我们！

Links

• Reference
• Guide (work in progress)
• GitHub
• npm

Contributing

欢迎请求请求！ 如果您看到要添加的内容，请添加。 对于剧烈的变化，请先打开一个问题。

Donating

您可以通过以下链接支持该项目的维护者

Disclaimer

此项目不隶属于、关联、授权、认可或以任何方式正式连接 WhatsApp 或任何其子公司或其附属公司。 WhatsApp 官方网站可在 https://whatsapp.com 找到。 “WhatsApp”以及相关名称、标志、标志和图像是其各自所有者的注册商标。

License

版权所有 2019 Pedro S Lopez

，根据 Apache 许可证 2.0 版（“许可证”）获得许可； 除非遵守许可证，否则您不得使用该项目。 您可以在 http://www.apache.org/licenses/LICENSE-2.0 获得许可证的副本。

除非适用法律要求或书面同意，软件 根据许可证分发是在“按原样”的基础上分发的， 没有任何明示或暗示的保证或条件。 请参阅许可证以获取特定语言的管理权限和 许可证下的限制。