用 AI 专业回复 WhatsApp 消息

WhatsApp 消息 → n8n 分流处理（文本/图片/音频/视频）→ Gemini 多模态理解 → AI Agent 生成回复 → WhatsApp 发回

给谁

需要在 n8n 中搭建 WhatsApp AI 聊天机器人的用户

你会得到

自动接收并理解 WhatsApp 文本、图片、语音、视频消息，通过 AI Agent 生成回复并发送回用户

你需要

n8n · whatsapp · gemini

步骤

1. 配置 WhatsApp 触发与消息分流

   在 n8n 中导入模板后，配置 WhatsApp Trigger 节点（订阅 messages 更新），并设置 Split Out Message Parts 节点将消息数组拆分。随后通过 Switch 节点（Redirect Message Types）按类型分流：audio、video、image、text（fallback）。

2. 转录音频消息

   对音频分支：使用 WhatsApp 节点获取音频文件 URL（Get Audio URL），再通过 HTTP Request 节点下载音频。随后调用 Google Gemini API（通过 HTTP Request）转录音频内容。

   运行提示词 · 来源原文。Google Gemini Audio 节点的 JSON Body 字段

   复制提示词

   ={{
   {
     "contents": [{
       "parts":[
         {"text": "Transcribe this audio"},
         {"inlineData": {
           "mimeType": `audio/${$binary.data.fileExtension}`,
           "data": $input.item.binary.data.data }
         }
       ]
     }]
   }
   }}

3. 描述视频消息

   对视频分支：使用 WhatsApp 节点获取视频文件 URL（Get Video URL），通过 HTTP Request 下载视频。由于 n8n 的 LLM 节点暂不支持视频二进制类型，需通过 HTTP Request 直接调用 Google Gemini API 进行视频描述。

   运行提示词 · 来源原文。Google Gemini Video 节点的 JSON Body 字段

   复制提示词

   ={{
   {
     "contents": [{
       "parts":[
         {"text": "Describe this video"},
         {"inlineData": {
           "mimeType": `video/${$binary.data.fileExtension}`,
           "data": $input.item.binary.data.data }
         }
       ]
     }]
   }
   }}

4. 分析图片消息

   对图片分支：使用 WhatsApp 节点获取图片 URL（Get Image URL），下载后传入 Image Explainer（Basic LLM Chain）节点，由 Gemini 模型描述图片内容并转录可见文字。

   运行提示词 · 来源原文。Image Explainer 节点的 Text 字段

   复制提示词

   Here is an image sent by the user. Describe the image and transcribe any text visible in the image.

5. 总结文本消息

   对文本分支（fallback）：通过 Wait 节点（Get Text）后直接传入 Text Summarizer（Basic LLM Chain），将用户消息简要总结以便 AI Agent 理解。

   运行提示词 · 来源原文。Text Summarizer 节点的 Messages > Message 字段

   复制提示词

   Summarize the user's message succinctly.

6. AI Agent 生成回复

   所有分支处理后的结果汇入 Get User's Message 节点，统一提取 message_type、message_text、from、message_caption。随后传入 AI Agent 节点，结合 Window Buffer Memory（按用户手机号会话）和 Wikipedia 工具生成回复。

   运行提示词 · 来源原文。AI Agent 节点的 Text 字段

   复制提示词

   =The user sent the following message
   message type: {{ $json.message_type }}
   message text or description:
   ```{{ $json.message_text }}```
   {{ $json.message_caption ? `message caption: ${$json.message_caption.trim()}` : '' }}

   运行提示词 · 来源原文。AI Agent 节点的 Options > System Message 字段

   复制提示词

   You are a general knowledge assistant made available to the public via whatsapp. Help answer the user's query succiently and factually.

7. 回复 WhatsApp 用户

   AI Agent 的输出通过 WhatsApp 节点（Respond to User）发送回原始发件人。该节点支持发送文本、图片、音频、视频、文档及位置信息；本模板演示仅发送文本回复。

你是一个 n8n 工作流搭建助手。用户希望复现「WhatsApp AI 聊天机器人」模板。请按以下顺序协助：1) 确认用户已拥有 n8n 实例、WhatsApp Business 账户及 Google Gemini API 凭证；2) 指导导入 workflow.json 并配置三个凭证（whatsAppTriggerApi、whatsAppApi、googlePalmApi）；3) 说明激活工作流前需完成 WhatsApp webhook 设置；4) 提醒大媒体文件可能影响性能，建议预处理。