WhatsApp-WebJS 不支持在单条消息中批量发送多张图片；所谓“多图消息”实为客户端界面的视觉聚合，底层仍需逐张调用 sendMessage 发送独立消息。

whatsapp-webjs 不支持在单条消息中批量发送多张图片；所谓“多图消息”实为客户端界面的视觉聚合，底层仍需逐张调用 `sendmessage` 发送独立消息。

WhatsApp-WebJS 的 client.sendMessage() 方法仅接受单个 MessageMedia 实例或纯文本字符串，不支持传入 mediaArray（如 [media1, media2, media3]）作为消息内容。你当前代码中：

const msg = await client.sendMessage(phoneNumber, mediaArray); // ❌ 错误：mediaArray 是数组，非合法参数

该调用虽不抛出 JavaScript 运行时错误（因库可能静默降级为发送空消息或忽略无效参数），但实际未触发有效发送逻辑，因此目标设备收不到任何内容——这正是你观察到“返回 success 但无消息抵达”的根本原因。

✅ 正确做法是：对每张图片单独构造 MessageMedia 并依次发送，配合合理延时（推荐 300–500ms）以避免频率限制或消息乱序：

Wjs Localizing Video

用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...

下载

async function sendMultipleImagesFromURLs() {
    const phoneNumber = '1234567890@c.us'; // 注意格式：国际号码 + @c.us
    const imageUrls = [
        'https://example.com/image1.jpg',
        'https://example.com/image2.jpg',
        'https://example.com/image3.jpg'
    ];

    try {
        for (let i = 0; i  setTimeout(resolve, 400));
            }
        }

        console.log('✅ All images sent successfully.');
    } catch (error) {
        console.error('❌ Failed to send image:', error.message);
        // 建议添加重试机制或日志记录具体失败 URL
    }
}

⚠️ 重要注意事项：

• URL 可访问性：确保所有图片 URL 支持 CORS（或通过服务端代理中转），否则 MessageMedia.fromUrl() 可能静默失败；
• 文件大小与格式：WhatsApp 限制单图 ≤ 16 MB，推荐 JPEG/PNG 格式；超限将导致媒体解析失败；
• 手机号格式：必须为完整国际格式（如 +1234567890@c.us），不可省略 @c.us 后缀；
• 会话初始化：确保 client.initialize() 后已触发 ready 事件再调用发送逻辑；
• 替代方案提示：若需“类相册”体验，可先发送文字说明（如“共3张图，请查收?”），再连续发送图片——用户 WhatsApp 客户端会自动将短时间内发送的多张图折叠显示为缩略图组。

总结：WhatsApp-WebJS 的设计严格遵循 WhatsApp Web 的原生行为，而官方 Web 端本身就不提供“单消息多附件”API。所谓“多图消息”只是 UI 层面对连续图片消息的聚合渲染，开发者必须按顺序、分批次调用 sendMessage 才能可靠送达。