> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Omnisend

> 通过已连接账户为电商业务提供营销自动化。

# Omnisend

当你需要将电商数据与 Omnisend 同步时，请使用此应用。它非常适合联系人、目录商品、购物车、订单和事件。

## 配置

| 选项 | 必填 | 描述 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Omnisend 账户。 |
| Action | 是 | 要执行的 Omnisend 操作（例如 List Contacts、Get Contact、Create or Update Contact、List Products）。 |
| Arguments | 是 | 根据该操作的 schema 生成的各操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于插入 `{{placeholder}}` 值。为高级用法提供了一个 **Raw JSON** 选项卡。 |
| When the step fails | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

在配置此步骤之前，请使用登录流程在你工作区的 **Integrations** 中连接 Omnisend。如果没有可用的有效连接，此步骤会显示一个警告，并提供指向 **Integrations** 的链接，而不是账户选择器。

## Arguments 表单

当你选择一个操作时，**Arguments** 部分会渲染一个由该操作输入 schema 驱动的表单。引用现有记录的字段包含下拉选择器。

当你更喜欢手动编写完整的 arguments 对象时，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## 常见操作

| 操作 | 描述 |
| - | - |
| **List Contacts** | 检索带分页的联系人列表，可选择性筛选。 |
| **Get Contact** | 通过 ID 检索单个联系人的详情。 |
| **Create or Update Contact** | 使用标识符创建联系人或更新现有联系人。 |
| **List Products** | 检索带分页的商品列表。 |
| **Get Product** | 通过 ID 检索特定商品的详情。 |
| **Create Product** | 在目录中创建新商品。 |
| **List Product Categories** | 检索带分页的商品分类列表。 |
| **Get Product Category** | 通过 ID 检索特定商品分类的详情。 |
| **Create Product Category** | 在目录中创建新的商品分类。 |
| **List Carts** | 检索带分页的购物车列表，可选择性筛选。 |
| **Get Cart** | 通过 ID 检索特定购物车。 |
| **Create Cart** | 创建新的购物车。 |
| **Create Order** | 创建包含总计和货币的新订单。 |
| **Get Order** | 通过 ID 检索特定订单的详情。 |
| **Send Event** | 向 Omnisend 发送客户事件。 |

删除记录等破坏性操作在工作流操作选择器中不可用。

## 输出

此步骤会将 Omnisend 的响应保存为步骤输出。响应的结构取决于该操作。

在后续步骤中使用完整的输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

1. 打开 **Integrations**，如果你还没有这样做，请先连接 Omnisend。
2. 将一个 **Omnisend** 步骤添加到你的工作流中。
3. 在 **Authentication** 中选择一个已连接账户。
4. 在 **Action** 中选择 **List Contacts**。
5. 填写必填字段。对任何字段值，使用 **Insert Variable** 引用前面步骤的输出。
6. 点击步骤标题中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的有效载荷。

## 使用场景

### 同步新客户

1. Create or Update Contact
2. Get Contact
3. Send Event

### 添加目录商品

1. Create Product
2. Get Product
3. List Products

### 跟踪订单

1. Create Order
2. Get Order
3. Send Event

## 备注

* 此步骤依赖于你工作区中已连接的 Omnisend 集成。
* 工作流操作选择器会显示一组精选操作。拥有 Omnisend 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌标识。

## 将 Omnisend 用作代理工具

你也可以在 **Agent Editor** 中将 Omnisend 添加为一个工具。打开代理，点击 **Add tool**，然后选择 **Omnisend**。在工具设置面板中，选择代理应使用的已连接账户。代理会在相关于对话时调用 Omnisend 操作。

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.