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

# Intercom

> Intercom 可通过你已连接的账户帮助你管理实时聊天、客户对话、联系人、工单、标签和公司记录。

# Intercom

当你需要在 Intercom 中查找、更新或回复联系人、对话、工单和公司时，请使用此应用。

## 配置

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

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

## Arguments form

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

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

## Common actions

| Action | Description |
| - | - |
| **Get contact** | 按 ID 获取单个联系人。 |
| **List contacts** | 按分页列出你工作区中的联系人。 |
| **Search contacts** | 使用查询筛选条件和运算符查找联系人。 |
| **Create contact** | 在 Intercom 中创建一个新联系人。 |
| **Update contact** | 更新现有联系人。 |
| **Attach contact to company** | 将联系人附加到某家公司。 |
| **Detach contact from company** | 将联系人从某家公司分离。 |
| **Get conversation** | 获取包含消息和详细信息的对话。 |
| **List conversations** | 按分页列出你工作区中的对话。 |
| **Search conversations** | 通过筛选和排序查找对话。 |
| **Create conversation** | 创建一个新对话。 |
| **Reply to conversation** | 向现有对话发送回复。 |
| **Close conversation** | 将对话标记为已解决。 |
| **Reopen conversation** | 重新打开已关闭的对话。 |
| **Assign conversation** | 将对话分配给管理员或团队。 |

诸如删除记录之类的破坏性操作在工作流操作选择器中不可用。

## 输出

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

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

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

## 示例

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

## Use cases

### 回复客户

1. Search conversations
2. Get conversation
3. Reply to conversation

### 创建支持工单

1. Search contacts
2. Create ticket
3. Update ticket

### 整理联系人

1. Get contact
2. Attach contact to company
3. Tag contact

## Notes

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

## 作为代理工具使用 Intercom

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

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