Node.js开发WhatsApp按钮/列表消息机器人遇阻求助

云上老周

2026-6-19

WhatsApp按钮/列表消息发送问题排查与解决方案

一、whatsapp-web.js 发送成功但无消息的解决办法

问题大概率是Buttons类的封装存在版本兼容问题，或者底层消息格式未正确生成，可按以下步骤修复：

更新到最新版本

npm install whatsapp-web.js@latest

替换为原生消息格式发送
放弃Buttons类，直接构造符合协议的消息对象，避免封装层的问题：

// 替换原Buttons相关代码
const buttonMessage = {
  text: "Choose an option:",
  buttons: [
    { body: "Option 1" },
    { body: "Option 2" },
    { body: "Option 3" }
  ],
  title: "Your Title Here",
  footer: "Your Footer Text Here"
};

try {
  await client.sendMessage(msg.from, buttonMessage);
  console.log('Buttons sent successfully!');
} catch (error) {
  console.error('Failed to send buttons:', error);
}

验证接收端兼容性
确保接收方的WhatsApp客户端版本在v2.21.18.10以上，旧版本不支持按钮消息。

二、Venom "无副标题" 错误的解决办法

问题根源是参数顺序错误+按钮格式不符合要求，修复如下：

修正参数顺序与按钮格式
Venom的sendButtons正确参数顺序为(to, text, buttons, subtitle, footer)，且按钮需包含id和text字段：

async function tryOptions(client, message) {
  const from = message.from;
  // 修正按钮格式
  const buttons = [
    {
      id: "btn1",
      text: "Text of Button 1"
    }
  ];
  // 修正参数顺序
  await client.sendButtons(
    from,
    "Choose an option",
    buttons,
    "Description of the buttons- subtitle",
    "Footer text here"
  );
}