WOZTELL 与 n8n 集成：如何连接并自动化工作流程

n8n 集成

在本文中，你将学习如何使用官方节点包（Community Node）将 WOZTELL 与 n8n 连接起来。通过此集成，你可以自动化流程，并将你的通讯渠道（WhatsApp、Messenger、Instagram、网站聊天）与其他应用和服务连接，无需自定义开发。
​
使用 n8n，你可以创建以下类型的工作流程：

  • 将每个新的 WhatsApp 潜在客户保存到 Google 表格中。

  • 当 CRM 记录状态发生变化时发送自动消息。

  • 根据条件在 WOZTELL 机器人中重定向用户。

Notes

注意：该插件目前在 n8n 的 WOZTELL 早期访问计划（EAP）中提供。不应在生产环境或处理敏感数据时使用。



什么是 n8n

n8n 是一款开源的工作流程自动化工具，允许你通过可视化界面连接应用、服务和数据库。得益于其低代码设计，你可以在无需从零编写代码的情况下创建复杂的集成流程。它还支持自托管，帮助你更好地控制数据和流程。
n8n 非常适合希望自动化重复任务、提升运营效率，并将 WOZTELL、CRM、电子表格、营销工具等平台连接在一起的企业。

将 n8n 与 WOZTELL 搭配使用的主要优势

  • 零代码自动化：通过可视化工作流程创建，无需编程知识。

  • 灵活性：可将 WOZTELL 与任何兼容 n8n 的系统或 API 集成。

  • 节省时间：自动化重复任务，如线索收集或客户跟进。

  • 可扩展性：随着业务增长，轻松扩展自动化逻辑。

  • 数据控制：在你的基础设施上部署 n8n，确保合规性和数据隐私。


要求

在开始之前，请确保你具备以下条件：

  • 一个 活跃的 WOZTELL 账户。

  • 至少一个 已连接的渠道（WhatsApp Cloud API、Messenger、Instagram 或网站聊天）。

  • 访问一个 n8n 实例（云端或自托管）。

  • WOZTELL 的管理员访问权限，以生成 访问令牌。


安装软件包

要在 n8n 中安装 WOZTELL 社区节点软件包：


1. 使用管理员权限登录 n8n。

2. 前往 Settings > Community Nodes。

3. 点击 Install。

4. 复制并粘贴以下软件包名称：@woztell-sanuker/n8n-nodes-woztell-sanuker。



5. 点击 Install。n8n 会下载该软件包并提供相应节点。

了解更多信息，请参阅 n8n 社区节点安装指南。


配置凭证

在使用该插件之前，你需要从 WOZTELL 平台获取 API 凭证。这些凭证充当访问 WOZTELL 产品 API 的身份验证密钥。确保根据你的使用场景启用所需权限，并在 n8n 的 WOZTELL 凭证配置中输入这些信息。

1. 在 n8n 中，转到 Credentials 并搜索 WOZTELL。




2. 登录你的 WOZTELL 账户并打开 访问令牌页面。

3. 启用以下权限：
  1. channel:list
  2. botapi:sendResponses
  3. bot:redirectMemberToNode
4. 生成新的访问令牌。



5. 复制该令牌并将其添加到 n8n 中的 WOZTELL 凭证配置中。


详细信息请参考 WOZTELL 访问令牌文档。

WhatsApp 模板消息的渠道 API 令牌：每个 WOZTELL 渠道都有一个用于 WhatsApp 模板消息的 Channel API Token。请将该令牌输入到 WOZTELL 凭证中的第二个令牌字段中。我们建议为每个渠道创建独立的凭证。更多信息请参阅：WhatsApp Cloud 公共 API。


创建你的第一个工作流

1. 打开 n8n 中的 工作流 面板。

2. 创建一个新的工作流。

3. 在节点面板中搜索 WOZTELL。

4. 将一个 WOZTELL 节点拖放到工作流中。
​
示例：创建一个流程，将每条传入的 WhatsApp 消息保存到 Google Sheets，并发送自动回复。

触发器和节点

概览

在侧边栏中搜索“WOZTELL”时，你将看到可用的节点和触发器。你可以将它们拖放到你的工作流中。

  • 触发器：接收来自 WOZTELL 渠道的 Webhook 数据。

  • Bot API 操作：通过 WOZTELL 发送消息并执行操作。

  • 成员操作：管理存储在 WOZTELL 中的联系人信息（查询、更新、标签）。


Webhook：收到 WOZTELL 消息时

此触发器接收来自任何 WOZTELL 渠道的 Webhook 消息，包括传入消息、传出消息以及成员更新事件。消息以 JSON 格式传递，包含事件详细信息。

你可以配置 Webhook 路径，并按渠道 ID 或事件类型进行筛选。


了解更多信息：WOZTELL Webhook 文档。

节点：发送回复

通过 WOZTELL 的 BotAPI，从你的 WhatsApp Business 号码向客户账户发送消息。消息的内容直接在“响应数据”中定义。

消息发送后，API 响应将可用于后续节点继续处理。

更多信息：发送回复 API 参考文档。


节点：重定向成员到节点

“重定向成员到节点”是一个特殊节点，用于将当前流程重定向到 WOZTELL 聊天机器人树中的某个特定位置。

你无需手动构建 JSON，有了这个节点，只需传递基础参数即可，WOZTELL 机器人将负责执行逻辑。

这个节点的作用就像一个指针——它将控制权交还给你现有的机器人结构，让其继续处理后续步骤。

适用于将 n8n 与 WOZTELL 聊天机器人集成的用户。

更多信息：重定向成员 API 参考文档。


节点：发送 WhatsApp 模板消息

根据 WhatsApp 的官方消息规则，如果你希望在 24 小时会话窗口之外联系用户，或者联系从未与你互动过的用户，必须使用预先批准的模板消息。

此 n8n 节点简化了该流程。你只需选择一个已批准的模板并填写所需字段，消息将以正确的格式自动生成并发送。


节点：根据标签获取成员

“根据标签获取成员”节点会从指定渠道中获取带有一个或多个标签的联系人。它使用 WOZTELL Open API 的“获取成员信息”接口，提取所有与所选标签相关的成员。

每次查询最多返回 100 条记录。如果结果数量超过该限制，你可以使用 Cursor 字段进行分页，或启用“返回全部”来自动获取所有记录。

使用该节点的步骤：
  1. 选择与你的 WOZTELL 账户绑定的凭证。
  2. 选择成员所在的对话渠道。
  3. 输入一个或多个标签（用逗号分隔）。仅返回带有这些标签的成员。
  4. 使用 Cursor 字段分页，或启用“返回全部”选项以获取所有结果。
输出结果包括一个成员对象列表，包含联系方式与元数据。

更多信息：WOZTELL Open API。


节点：设置成员标签

“设置成员标签”节点允许你使用 WOZTELL Open API 向指定渠道的联系人添加一个或多个标签。

标签在 WOZTELL 的多个功能中被广泛使用，例如活动（Broadcast）、联系人管理和聊天机器人构建器。通过标签，你可以细分用户、追踪业务状态，并根据用户行为或资料定制工作流。

该节点可插入在任何需要根据标签执行业务逻辑的流程中。

使用该节点的步骤：

  1. 选择与你 WOZTELL 账户相关联的凭证。
  2. 选择联系人的会话渠道。
  3. 输入成员的 External ID（例如 WhatsApp 的电话号码）。
  4. 添加一个或多个标签，用逗号分隔。

执行后，联系人将被更新为指定的标签。你可以用这些标签来筛选用户、发起活动或触发条件流程。

更多信息：WOZTELL Open API。

节点：根据 ID 获取成员信息

该节点通过 External ID 在特定渠道中获取某个成员的资料。对于 WhatsApp 渠道，External ID 对应用户的电话号码。

它会返回完整的联系人数据，包括元数据，以及（在最新版本中）会话当前在收件箱的位置。

使用该节点的步骤：
  1. 选择与你 WOZTELL 账户关联的凭证。
  2. 选择相应的渠道。
  3. 输入联系人的 External ID。
当工作流需要获取最新联系人信息，或需要跨系统同步数据时，该节点非常有用。

更多信息：WOZTELL Open API · 收件箱概览。


节点：根据 ID 获取对话历史

“根据 ID 获取对话历史”节点可根据 External ID 和设定的时间范围获取某个联系人的历史对话。

这在审计、支持流程或通过分析过往交互提升聊天机器人训练方面非常实用。

使用该节点的步骤：
  1. 选择与你 WOZTELL 账户关联的凭证。
  2. 选择会话渠道。
  3. 输入联系人的 External ID。
  4. 设置查询的时间范围（开始和结束时间戳）。
注意
注意：
时间范围是必填项。否则查询可能由于数据量过大而失败。

如果预期结果超过 100 条，请使用 Cursor 字段进行分页，或启用“返回全部”选项。

更多信息，请参阅 WOZTELL Open API。


使用案例

  • 潜在客户捕获：将 WhatsApp 潜在客户保存到 Google Sheets，并发送确认消息。

  • CRM 集成：更新 CRM 中的记录，并使用 WOZTELL 触发 WhatsApp 通知。

  • 聊天机器人路由：使用“将成员重定向到节点”操作将客户从支持流程转移到销售流程。


最佳实践

  • 独立环境：使用专用测试环境测试新流程，然后再将其部署到生产环境中。

  • 令牌管理：确保访问令牌的安全，限制其使用范围，并定期更换。

  • 错误处理：在 n8n 中添加错误分支和重试逻辑，以确保流程在遇到临时问题时能够恢复。

  • 监控与日志：查看 n8n 中的执行日志，以跟踪性能并排查问题。

  • 可扩展性：从简单流程开始，随着业务增长逐步扩展。


如果你在操作过程中有任何疑问，请通过官方支持门户联系 WOZTELL 支持团队。