# n8n集成

### 概述

YCloud 支持通过 n8n 进行自动化集成。

n8n 是一款开源的可视化工作流自动化平台，可用于将 YCloud Webhook、API 事件与第三方系统（如 CRM、数据库、AI 服务等）进行灵活连接。

在 YCloud 的典型使用场景中，n8n 常用于：

* 接收 YCloud Webhook 事件
* 对消息或用户行为进行条件判断与处理
* 调用 AI / 外部 API 进行分析
* 将结果同步至 CRM、内部系统或数据仓库

***

### 使用前准备

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

* 已部署并可访问的 n8n 实例
* 已获取 n8n 的登录账号与权限
* 如需调用大模型或第三方 API，请提前准备对应的 API Key

***

### n8n 官方文档

关于 n8n 的安装、基础概念与使用方式，请直接参考 n8n 官方文档：

👉 [https://docs.n8n.io](https://docs.n8n.io/)

以下内容在官方文档中已有完整说明：

* Workflow（工作流）与 Node（节点）的基本概念
* Webhook Trigger 的配置方式
* Expression（表达式）语法
* Credentials（凭证）管理
* Execution（执行记录）与调试方法

***

### 与 YCloud 的集成方式

在 YCloud 中，可将 Webhook 地址 配置为 n8n 的 Webhook URL，使 n8n 成为事件处理的中间层。

您可以访问[https://n8n.io/integrations/ycloud-whatsapp](https://n8n.io/integrations/ycloud-whatsapp/) 获取安装，或直接在节点中搜索 YCloud WhatsApp。

### 说明

* 建议在 n8n 中区分 测试环境（Test URL） 与 生产环境（Production URL）
* 请妥善管理 API Key、Webhook 地址等敏感信息


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpdocs.ycloud.com/help-center/zh/developer/n8n_integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.