如何在 WOZTELL 中使用 OpenAI 创建 AI 聊天机器人

如何在 WOZTELL 中使用 OpenAI 创建 AI 聊天机器人


如何在 WOZTELL 中使用 OpenAI 创建 AI 聊天机器人

将由 OpenAI 驱动的助手连接到 WhatsApp、Instagram、Facebook Messenger 和 Webchat。

指南版本： GPT Assistant v1.3.0 · Responses API · User Guide

本指南说明如何在 WOZTELL 中使用 GPT Assistant 扩展和 OpenAI 的 Responses API 配置 AI 聊天机器人。

通过该扩展，你可以创建一个能够在 WhatsApp Business Platform、Instagram、Facebook Messenger 和 Webchat 中自动回复的助手。你也可以在 WOZTELL Inbox 中启用 AI 回复建议，帮助人工客服在实时对话中更快、更准确地回复客户。

配置步骤 你将配置的内容
1 添加你的 OpenAI API Key。
2 配置 AI Chatbot、AI Inbox Replies、Knowledge Base 和工具。
3 将助手连接到一个或多个 WOZTELL 频道。
重要： 开始之前，请确保你的 WOZTELL 账户中已经至少连接了一个频道。支持的频道包括 WhatsApp Business Platform / WhatsApp Cloud API、Instagram、Facebook Messenger 和 Webchat。

步骤 1 — 安装 GPT Assistant 扩展

1.1 访问 Marketplace

前往 Marketplace → + New Extension。

图 1 — 从 WOZTELL 导航栏打开 Marketplace。

在 Marketplace 中，找到 ChatGPT 扩展卡片：Artificial Intelligence · OpenAI | WOZTELL，然后点击 Learn More。

图 2 — 在 Marketplace 中选择 ChatGPT 扩展。

1.2 配置安装信息

字段 操作说明
Extension Version 选择 v1.3.0。
Alias 输入一个唯一的小写名称，不要包含空格。例如：my-gpt-assistant。
Description 可选。添加一段简短说明，用于描述该助手的用途。

然后点击 Install。如果看到错误提示 “App Integration with alias already exists”，请使用另一个 alias。

安装完成后，在 Installed Extensions 中点击该扩展名称，打开配置窗口。你将看到三个主要部分：API Key Setup、Configuration 和 Connect to Channel。

步骤 2 — 添加你的 OpenAI API Key

必须先添加 OpenAI API Key，才能进入配置和频道连接部分。该密钥允许 WOZTELL 向你的 OpenAI 账户发送请求。

图 3 — GPT Assistant 扩展中的 API Key 配置字段。

2.1 在 OpenAI 中生成 API Key

在 API Key Setup 部分，点击 generate one here。系统会在新标签页中打开 platform.openai.com。

  1. 进入 API Keys。
  2. 点击 + Create new secret key。
  3. 添加一个便于识别的名称，例如：woztell-gpt-assistant。
  4. 除非你的 OpenAI 账户使用特定项目结构，否则将项目保留为 Default。
  5. 点击 Create secret key。
  6. 立即复制该密钥。
图 4 — 在 OpenAI 中创建新的 secret key。
图 5 — 确认并创建 secret key。
重要： OpenAI 只会完整显示该密钥一次。关闭弹窗后，你将无法再次查看完整密钥。不要分享你的 API Key，因为它与 OpenAI 计费相关。如果密钥泄露，请立即在 OpenAI 中撤销该密钥，并生成新的密钥。

2.2 将密钥粘贴到 WOZTELL

返回 WOZTELL，将密钥粘贴到 API Key 字段中，然后点击 Save。绿色勾号表示密钥有效。保存后，Configuration 和 Connect to Channel 部分将变为可用。

图 6 — 在 WOZTELL 中保存 OpenAI API Key。

步骤 3 — 配置 AI 助手

Configuration 部分用于定义助手的行为。它包含三个主要区域：

区域 用途
AI Chatbot 配置连接频道中的自动聊天机器人回复。
AI Inbox Replies 在 WOZTELL Inbox 中为人工客服生成 AI 回复建议。
Knowledge Base 上传助手在回答问题时可以检索的文档。
重要： 切换到其他标签页之前，请先保存当前标签页。未保存的更改可能会丢失。

3.1 AI Chatbot — 核心配置

AI Chatbot 部分控制助手在自动回复用户时的行为。对于基础聊天机器人，你只需要配置 Model 和 Instructions。

必填字段

字段 操作说明
Model 选择用于生成回复的 OpenAI 模型。模型列表会从你的 OpenAI 账户实时获取。推荐起点：gpt-4o mini，它适合大多数聊天机器人场景，速度快、成本较低且稳定。
Transcription Model 用于将语音消息转换为文本。默认通常是 whisper-1。除非有明确原因，否则建议保持默认设置。
Instructions 系统提示词，用于定义助手的角色、语气、规则和行为。每次对话前，这些说明都会发送给模型。

WOZTELL 也提供了一个 prompt 生成器，帮助你为助手创建更好的 Instructions：https://woztell.com/perfect-prompt-generator/

如何编写有效的 Instructions

Instructions 应清楚定义助手的角色、语气、范围和任务。

You are a presales assistant for WOZTELL.

Your goal is to help companies understand how WOZTELL can help them automate conversations across WhatsApp, Instagram, Facebook Messenger, and Webchat.

Be friendly, concise, and professional.

Only answer questions related to WOZTELL, WhatsApp Business Platform, AI chatbots, integrations, automation, and conversational channels.

If the user asks about something unrelated, politely explain that you can only help with WOZTELL-related topics.

Before qualifying the lead, ask for their name, company, website, and main use case.
元素 示例
Role “You are a presales assistant for WOZTELL.”
Tone “Be friendly, concise, and professional.”
Scope “Only answer questions about our products and services.”
Tasks “Ask for the user’s name, company, website, and use case before qualifying the lead.”
Escalation “If the user asks for pricing, complex integrations, or technical support, recommend speaking with the WOZTELL team.”

3.2 Advanced Settings

这些字段是可选的。大多数用户可以保留默认值。只有在需要更精细地控制助手行为，或正在处理自定义集成时，才建议修改这些设置。

字段 作用 建议
Temperature 控制回复的创造性或一致性。数值越低，回答越稳定；数值越高，回答越多样。 推荐：0.5。部分模型可能不支持该参数。如果不兼容，错误会显示在 logs 中。
Top P 另一种控制回复多样性的方式。 使用 Temperature 或 Top P 其中之一即可，不建议同时使用。
Number of chat history messages used to provide context 定义生成新回复时会使用多少条历史消息作为上下文。 默认：10。更高的数值可能改善上下文理解，但会增加 token 消耗。建议上限约为 20 条消息。
Max Chat Session Duration 定义会话保持活跃的天数。会话过期后，会创建新的 thread，并重新加载历史上下文。 默认：3 天。更长的会话可能增加 token 消耗。
Format 定义预期输出结构。 普通聊天机器人请选择 Text。只有技术集成场景才使用 JSON Schema 或 JSON Object。

3.3 Tools

Tools 允许助手访问额外信息或执行外部动作。要添加工具，请点击 Tools 旁边的 + 图标。

图 7 — 为助手添加 File Search 等工具。

允许助手实时搜索网络。当助手需要基于最新信息回答时，可以使用该工具。你也可以使用 Domain Filtering 将搜索范围限制到指定网站。

woztell.com
support.woztell.com

不要输入带有 https:// 的完整 URL。

正确 错误
woztell.com https://woztell.com/

允许助手搜索存储在 Knowledge Base / Vector Store 中的文件。当助手需要基于上传的文档、FAQ、产品资料、内部指南或商业材料回答问题时，可以使用该工具。

使用 File Search 之前，必须先创建 Knowledge Base 并上传文件。然后在 File Search 工具中选择对应的 Vector Store。

Function Call

允许助手执行外部动作，例如查询订单状态、检索客户数据或触发工作流。该选项需要自定义技术集成。大多数用户在基础配置中不需要配置 Function Call。

重要： 切换标签页之前，请点击 Save。

3.4 AI Inbox Replies

AI Inbox Replies 功能用于帮助人工客服在 WOZTELL Inbox 中更快地回复客户。

与 AI Chatbot 不同，该功能不会自动向客户发送回复。它会生成回复建议，由客服人员审核、编辑并手动发送。

  • 客服正在处理实时对话。
  • 客服需要帮助来写出清晰的回复。
  • 团队希望提高回复速度，同时保留人工控制。
  • 对话需要上下文、同理心或人工确认。

扩展启用后，AI 回复建议会通过 WOZTELL Inbox 的 Power Apps 区域提供。

如何配置 AI Inbox Replies

字段 操作说明
Model 选择用于生成回复建议的 OpenAI 模型。
Instructions 定义助手应该如何为客服人员撰写建议回复。该 prompt 会应用于整个 WOZTELL Inbox，因此建议保持通用。

推荐 Instructions 示例

You are an AI assistant helping WOZTELL agents write better replies inside the Inbox.

Generate clear, concise, and professional suggestions based on the conversation context.

Do not make promises about pricing, delivery times, technical feasibility, or contract conditions unless they are explicitly confirmed in the conversation.

Keep the tone friendly and helpful.

If the customer asks for something that requires human validation, suggest escalating the conversation to the appropriate team.

AI Inbox Replies 的高级设置

字段 作用 建议
Temperature 控制回复建议的创造性。 推荐：0.5。
Max Tokens 定义每条建议的最大长度。数值越高，回复可以越长。 使用适中的数值，以保持回复简洁。
Number of Suggestions 定义每条消息生成多少个回复选项。 推荐：2 或 3 个建议。
Previous messages used as context 定义用于生成建议的历史消息数量。 推荐：5。更多上下文可能提升准确性，但会增加成本。

3.5 Knowledge Base — Vector Stores

Knowledge Base 允许你上传文档，供助手在回答问题时检索。Vector Store 类似一个文件夹：你可以将多个文件上传到同一个 Knowledge Base，也可以删除单个文件或整个文件夹。

图 8 — 在 WOZTELL 中创建和管理 Knowledge Bases / Vector Stores。
Knowledge Base 适用于... 示例
产品文档 功能指南、配置说明、技术文档。
FAQ 关于价格、onboarding、频道、集成或支持的常见问题。
商业材料 Sales decks、one-pagers、服务说明。
内部流程 升级规则、支持 playbooks、资格判断规则。

如何创建 Knowledge Base

  1. 点击 + New Knowledge Base。
  2. 输入一个描述性名称，例如：woztell-faq。
  3. 点击上传图标。
  4. 拖拽文件，或从设备中选择文件。
  5. 等待文档处理完成。
  6. 返回 AI Chatbot 配置。
  7. 添加 File Search 工具。
  8. 选择你创建的 Knowledge Base / Vector Store。
支持的格式： PDF、DOCX 和 TXT。建议使用清晰、结构良好的文档。文档越清楚，助手越容易检索到准确的信息。

步骤 4 — 将助手连接到频道

Connect to Channel 部分用于选择助手在哪些地方生效。你可以将同一个助手连接到 WOZTELL 账户中的一个或多个频道。

图 9 — 将 GPT Assistant 连接到频道和环境。
助手示例 频道 使用场景
AI-CHATBOT-WHATSAPP-PRESALES WhatsApp 线索资格判断和销售问题。
AI-CHATBOT-INSTAGRAM-SUPPORT Instagram 社交电商和支持。
AI-CHATBOT-WEBCHAT-FAQ Webchat 网站常见问题自动化。
AI-CHATBOT-FACEBOOK-LEADS Facebook Messenger 入站线索管理。

理解频道和环境

频道 是连接到 WOZTELL 的沟通渠道，例如 WhatsApp、Instagram、Facebook Messenger 或 Webchat。

环境 是频道内的工作空间，可用于区分测试、开发或生产配置。如果你没有创建额外环境，助手将使用 default 环境。

  • 上线前测试聊天机器人。
  • 为特定测试用户开通白名单。
  • 分离开发和生产配置。
  • 在不同上下文中运行不同助手。

如何连接助手

  1. 进入 Section 3 — Connect to Channel。
  2. 找到你希望启用助手的频道和环境。
  3. 点击 Connect。
  4. 如果系统要求，输入 Prefix Name。
  5. 点击 Confirm。
  6. 再次点击 Connect。

连接成功后，按钮会变为 Disconnect。这表示聊天机器人已在该频道和环境中上线。

什么是 Prefix Name

Prefix Name 用于识别连接到特定频道或环境的助手。建议使用能够说明频道和场景的清晰名称。

AI-CHATBOT-WHATSAPP-PRESALES
AI-CHATBOT-INSTAGRAM-SUPPORT
AI-CHATBOT-WEBCHAT-FAQ
AI-CHATBOT-FACEBOOK-LEADS

推荐命名结构：

AI-CHATBOT-[CHANNEL]-[USE-CASE]

步骤 5 — 测试你的聊天机器人

连接助手后，在面向真实客户使用之前，应先进行测试。

推荐测试流程

  1. 进入 WOZTELL 中已连接的频道。
  2. 从另一台设备、账号或号码发送消息。
  3. 检查助手是否正确回复。
  4. 确认回复是否符合你的 Instructions。
  5. 测试不同类型的问题。
  6. 测试边界情况，例如超出助手范围的问题。
  7. 如果出现异常，请查看 logs。

建议测试问题

用于售前助手

你好，我想为我的公司自动化 WhatsApp。
WOZTELL 可以把 WhatsApp 和 Instagram 连接起来吗？
我可以把它用于客户支持吗？
价格是多少？
我可以和人工客服沟通吗？

用于支持助手

我如何连接我的 WhatsApp 号码？
为什么我的模板没有被批准？
我在哪里可以查看我的对话？
我如何上传联系人？

上线前最佳实践

最佳实践 需要检查的内容
检查 Instructions 角色、语气、范围、任务、限制和升级规则都应清晰。
上传干净的 Knowledge Base 文档应为最新版本，结构清晰，且不包含重复或互相矛盾的信息。
使用真实场景测试 不要只测试简单问题。应使用真实对话、异议和模糊消息进行测试。
监控 token 消耗 更多上下文、更长会话、更大的 Knowledge Base 和更长回复都可能增加消耗。
保留人工升级路径 对于销售、支持、价格、账单和技术问题，建议允许助手升级给人工客服。
定期查看 logs Logs 可帮助发现 API Key、模型、工具、prompt、File Search 或频道连接问题。

Troubleshooting

如果助手没有按预期回复，请先查看 logs。大多数错误消息直接来自 OpenAI，通常会说明问题所在。

问题 可能原因 解决方法
API Key not accepted 密钥复制错误、已被撤销或无效。 在 OpenAI 中生成新密钥，并重新粘贴到 WOZTELL。
Alias error during installation 该 alias 已在你的 WOZTELL 账户中使用。 选择另一个 alias。
Sections 2 or 3 are not accessible API Key 尚未保存。 先在步骤 1 中保存 API Key。
Model does not appear in the list 你的 OpenAI 账户没有访问该模型的权限。 检查 OpenAI 账户、项目和模型权限。
Assistant is not responding 频道未连接，或 API Key 无效。 检查频道连接，并确认 API Key 仍然有效。
Temperature or Top P error appears in logs 所选模型不支持该参数。 关闭该参数，或切换到兼容模型。
File Search is not working 未上传文件、选择了错误的 Vector Store，或未将 File Search 添加为工具。 上传文件，选择正确的 Knowledge Base，并确认 File Search 已启用。
Assistant answers with incorrect information Instructions 不清晰，或 Knowledge Base 包含不完整/矛盾的信息。 优化 prompt，并检查上传的文档。
Two OpenAI accounts are connected to the same channel 同一频道中已启用另一个 GPT Assistant 扩展。 先断开现有扩展，再连接新的扩展。

最终建议

聊天机器人配置并测试完成后，应基于真实对话持续优化。定期查看客户问题、更新 Knowledge Base、调整 Instructions，并监控助手表现。

配置良好的 AI 助手可以帮助你的团队自动化重复对话、支持 Inbox 中的人工客服、更快地判断线索质量，并在 WhatsApp、Instagram、Facebook Messenger 和 Webchat 中提供一致的回复体验。