用 n8n + WOZTELL + Google Gemini 搭建 WhatsApp AI 自动回复

将 WhatsApp inbound 消息通过 webhook 接入 n8n，过滤后提取对话上下文，由 Gemini 生成回复，再经 WOZTELL 发回客户

给谁

已有 n8n 实例、WOZTELL WhatsApp 频道和 Gemini API key 的团队

你会得到

客户发来 WhatsApp 文字消息后，系统自动基于近期对话历史生成专业回复并发送

你需要

n8n

步骤

1. 导入模板

   在 n8n 工作流界面通过模板 ID 13641 导入「Build an AI agent for WhatsApp with WOZTELL and Google Gemini」。导入后可见 Webhook、Filter、Get conversation history、Edit Fields、AI Agent、Google Gemini Chat Model、Send responses 等节点。

2. 配置 WOZTELL Webhook

   激活工作流后，复制 Webhook 节点的 Production URL，粘贴到 WOZTELL 的 inbound webhook 设置中。事件订阅选择 Inbound Messages。在 Member Metadata 字段填入：Member Metadata: liveChat；Member Path: member.botMeta.liveChat。

   搭建指导 · 来源原文。WOZTELL inbound webhook 配置界面

   复制提示词

   After activating this workflow, copy the **Production URL** and paste it into your WOZTELL inbound webhook settings.
   
   Check how to configure the webhook [here](https://support.woztell.com/portal/en/kb/articles/web#Create_Webhooks).
   
   Select **Inbound Messages** in the Event Subscriptions.
    
   In the Member Metadata field, fill in the following details:
   Member Metadata: **liveChat**
   Member Path: **member.botMeta.liveChat**

3. 连接 WOZTELL 凭证并设置历史记录权限

   在 n8n 凭证管理中添加 woztellCredentialApi 类型凭证。需要生成 WOZTELL access token，权限包括：channel:list、channel:getBasicInfo、member:getConversations、bot:sendResponses、member:getDetails。如已有 Channel API token 可复用。Get conversation history 节点默认读取最多 10 条历史消息。

   搭建指导 · 来源原文。WOZTELL 凭证配置与 access token 生成指引

   复制提示词

   Reads up to 100 messages for the account to provide context to the AI.
   
   Set up your WOZTELL credentials. To generate the access token, follow the step-by-step guide [here]( https://support.woztell.com/portal/en/kb/articles/access-token#Access_Token_Generation).
   
   Required permissions:
   - channel:list
   - channel:getBasicInfo
   - member:getConversations
   - bot:sendResponses
   - member:getDetails
   ###
   For the WOZTELL Channel API field, follow [this guide](https://support.woztell.com/portal/en/kb/articles/access-token-channels-in-woztell#How_to_Create_an_Access_Token_for_a_Channel_in_WOZTELL) to create a new token. If you have already generated a token, you may reuse it.

4. 连接 Google Gemini 凭证

   在 n8n 凭证管理中添加 googlePalmApi 类型凭证，填入 Gemini API key。AI Agent 节点通过 Google Gemini Chat Model 子节点调用，默认 maxOutputTokens 为 1000。可按需调整 token 上限或更换为其他支持的模型。

   搭建指导 · 来源原文。Google Gemini 凭证配置节点说明

   复制提示词

   Google Gemini Chat Model provides the AI language model used to generate replies.
   
   Connect your Google Gemini API key. Follow the official n8n documentation [here](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatgooglegemini/).
   
   You can adjust token limits or switch to another supported model if needed.

5. 激活工作流并测试

   激活工作流。向 WOZTELL 绑定的 WhatsApp 号码发送文字消息。若 eventType=inbound、type=text 且 liveChat=false，系统会检索历史对话、格式化后送入 AI Agent，由 Gemini 生成仅含纯文本的回复，再通过 WOZTELL 发回客户。若条件不满足则静默忽略。

You are a Professional Conversation Analyst and Reply Generator Agent. Analyze the provided conversation snippets. Generate a single, concise, and contextually appropriate reply that directly addresses the last [Customer] statement in a professional tone, (Output **ONLY the plain text** of the reply).