> ## 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.

# Webex

> Webex 允许你通过已连接的账户管理会议、房间、团队、消息和人员。

# Webex

当你的工作流需要创建或更新团队和房间、发送消息，或者查找人员和成员关系时，可以使用 Webex。它适用于需要来自你已连接账户的协作数据的步骤。

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | 工作流画布中该步骤的标签。 |
| Authentication | Yes | 此步骤要使用的已连接 Webex 账户。 |
| Action | Yes | 要执行的 Webex 操作（例如 Get Team Details、List Teams、Create Room、Get Room Details）。 |
| Arguments | Yes | 根据操作的架构生成的各操作专用表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于插入 `{{placeholder}}` 值。还有一个 **Raw JSON** 选项卡可用于高级用法。 |
| When the step fails | No | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## Arguments form

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

如果你更愿意手动编写完整的参数对象，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## Common actions

| Action | Description |
| - | - |
| **Get Team Details** | 获取特定团队的详细信息。 |
| **List Teams** | 列出已认证用户所属的团队。 |
| **Create Room** | 创建一个新的 Webex 房间以用于协作。 |
| **Get Room Details** | 获取特定房间的详细信息。 |
| **List Rooms** | 列出已认证用户所属的房间。 |
| **Update Room** | 更新房间的标题、锁定状态或团队关联。 |
| **Create Message** | 向 Webex 房间或个人发送一条消息。 |
| **Get Message Details** | 获取特定消息的详细信息。 |
| **List Messages** | 列出房间中的消息。 |
| **Get Person Details** | 获取特定人员的详细个人资料信息。 |
| **List People** | 列出你组织中的人员。 |
| **List Memberships** | 列出 Webex 房间中的成员关系。 |
| **Get Membership Details** | 获取特定房间成员关系的详细信息。 |

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

## Output

此步骤会将 Webex 响应存储为步骤输出。响应的结构取决于所选操作。

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

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

## Example

1. 打开 **Integrations**，如果你还没有连接过 Webex，就先连接它。
2. 在你的工作流中添加一个 **Webex** 步骤。
3. 在 **Authentication** 中选择一个已连接账户。
4. 在 **Action** 中选择 **Get Team Details**。
5. 填写必填字段。对于任何字段值，都可以使用 **Insert Variable** 来引用前一个步骤的输出。
6. 点击步骤标题栏中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的载荷。

## Use cases

### Create a team and room

1. Create Team
2. Create Room
3. Create Message

### Review room activity

1. List Rooms
2. Get Room Details
3. List Messages

### Find a person

1. List People
2. Get Person Details

## Notes

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

## Using Webex as an Agent Tool

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

另请参阅：[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.