**要创建用于查询运费报价的 Capitão 工具（Tool），请在 Papo 平台（https://papo.global/）使用自定义 HTTP Tool。它会把助手连接到你的承运商或物流平台 API，让 AI 解读客户发送的目的地 CEP、重量和尺寸等数据，查询外部系统，并在 WhatsApp 对话期间自动返回运费金额。**

有了这项配置，Capitão 不再只是解答疑问的助手，而会执行实际的物流操作。客户可以问“到 CEP 02030‑040 的运费是多少？”，并立即收到类似“该 CEP 的运费为 R$ 18,90，预计 3 个工作日送达”的回复，无需人工介入。这能减少购买摩擦、加快服务速度，并让团队腾出精力处理更复杂的谈判。

## 配置摘要

| 步骤 | 要做什么 | 说明 |
| :--- | :--- | :--- |
| **1. 访问 Capitão 设置** | 在 Papo 中打开助手设置。 | 菜单的确切名称可能有所不同。 |
| **2. 创建自定义工具** | 使用 HTTP 类型将 Capitão 连接到承运商 API。 | 需要 HTTP 请求的技术知识。 |
| **3. 定义端点** | 填写计算运费的 API URL（例如：Correios、Braspress、Intelipost）。 | 示例：`https://api.transportadora.com/v1/cotacao`。 |
| **4. 配置方法和认证** | 使用 POST 或 GET，并带上安全请求头，例如访问 token。 | 示例：`Authorization: Bearer sua_chave_api`。 |
| **5. 发送报价数据** | 允许 Capitão 从对话中提取 CEP、重量、尺寸或 API 要求的其他参数。 | 操作会根据客户提供的信息动态变化。 |
| **6. 关联到 WhatsApp** | 在 WhatsApp 收件箱中启用助手。 | 查询会在服务中实时生效。 |

## Capitão 如何查询运费

流程把客户的常见问题连接到实时计算：

1. **客户请求报价：** 发送类似“到 CEP 04123‑000 的运费是多少？”的消息。
2. **Capitão 解读意图：** 根据工具说明和描述，它识别出应使用运费查询 Tool。
3. **触发工具：** 助手把从对话中提取的值（CEP、商品重量等）发送到承运商端点。
4. **API 返回金额和时效：** 外部系统返回包含可用运费选项的 JSON。
5. **Capitão 回复客户：** AI 把这些数据转化为自然回复，例如“我们有 PAC，R$ 22,90（7 天）和 Sedex，R$ 39,50（2 天）”。

整个过程无需人工坐席复制 CEP 并打开另一个系统。

## 配置运费查询 Tool 的前提条件

创建工具前，需要具备：

- **已创建 Capitão 助手**：在 Papo 平台中，已定义名称和描述。
- **可用的承运商 API**：来自 Correios、物流平台（Intelipost、Frenet、SuperFrete）或你自己的配送管理系统。
- **端点 URL**：用于计算运费、将被调用的 URL。
- **认证凭据**（API key、token 或特定请求头），以确保请求安全。
- **API 和 HTTP 请求知识**，因为自定义工具配置属于高级操作。

如果你的承运商不提供公开 API，就需要开发一个中间层，或使用已经暴露端点的报价解决方案。技术规格应与开发团队或供应商文档确认。

## 物流的原生工具 vs. 自定义工具

Papo 为 Capitão 提供两类工具：

| 类型 | 描述 | 使用示例 | 技术知识 |
| :--- | :--- | :--- | :--- |
| **原生** | 平台中预配置、可直接使用的集成。 | 在 Google Calendar 中安排演示。 | 低，只需启用并连接账户。 |
| **自定义（HTTP）** | 通过 API 连接外部系统的自定义操作。 | 在 WhatsApp 中实时查询运费报价。 | 高级，需要 API 和 HTTP 请求。 |

要查询运费报价，推荐路径是自定义 HTTP 工具，因为计算取决于每家承运商或物流运营商。不存在适用于任何承运商的通用原生集成；你需要使用自己所使用的报价服务的特定端点。

## 为运费查询配置自定义 Tool

启用此自动化的概念流程遵循清晰逻辑，无需记住屏幕或按钮名称：

1. **访问助手设置：** 在 Papo 面板中，前往管理工具所在的 Capitão 配置区域。
2. **创建自定义 HTTP 类型的工具：** 选择允许通过 API 连接外部系统的选项。
3. **填写请求数据：** 填写承运商端点 URL、HTTP 方法（通常是 POST，因为你发送 CEP 并接收计算结果）以及认证请求头，例如 `Authorization: Bearer sua_chave`。
4. **定义动态参数：** 最大优势是 Capitão 可以使用客户在对话中提供的信息。你可以配置工具发送消息中出现的 CEP、商品默认重量或包裹尺寸。工具会自动解读这些值。
5. **指导 Capitão 如何回复：** 在工具描述或助手指南中，你可以引导 AI 以友好的方式呈现金额和时效，例如“您到 CEP … 的运费为 R$ …，预计 … 送达”。
6. **将助手关联到收件箱：** 确保 Capitão 已为 WhatsApp（或客户提问的其他渠道）启用。

配置完成后，任何提到“运费”“报价”或“发货”的消息都会触发该流程——只要 Capitão 识别出意图。最终回复来自承运商的真实数据，无需员工介入。

## 常见问题

### 使用此 Tool 是否必须拥有承运商 API？

是。自定义 HTTP 工具通过调用返回运费金额的端点来工作。如果你的承运商不提供 API，你可以使用报价服务（如 Intelipost、Frenet 或 SuperFrete），它们整合多家承运商并提供单一端点。

### Capitão 如何知道使用哪个 CEP 或重量？

配置期间，你可以指明 CEP 值应直接从客户消息中提取。工具使用动态变量捕获这些数据。根据你给出的指令，如果信息不完整，助手也可以向客户确认。

### 配置是否需要开发人员？

是。创建自定义 HTTP 工具需要 API、HTTP 方法和认证知识。通常由开发人员或具备集成经验的人完成此步骤。Papo 不提供承运商端点，只提供连接它的基础设施。

### 运费报价会记录在 Papo CRM 中吗？

对话历史和生成的回复会保存在收件箱中。Papo 不会自动在特定模块（如 Kanban 中的商机）中创建报价记录，但你可以使用其他自动化（如 webhooks）补充流程，从该互动创建线索或任务。

### 我可以使用同一个 Tool 查询配送时效吗？

可以。通常运费 API 的返回已经包含预计时效。可以将 Tool 配置为在 Capitão 的回复中同时显示金额和时效。

### 使用自定义工具是否会产生额外费用？

自定义工具属于 Capitão 功能的一部分，适用于有权访问该资源的账户。有关不同套餐的可用性详情，请查阅 Papo 网站。

## 另请阅读

- [如何配置 Capitão 实时查询订单状态](/hc/papo/articles/how-to-configure-captain-for-real-time-order-status)
- [如何生成 Papo API 的公钥和私钥](/hc/papo/articles/how-to-generate-papo-api-public-and-secret-keys)

---

**[免费开始，创建带智能工具的助手 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=how-to-create-captain-freight-quote-tool&utm_content=zh_CN)**

用 AI 在 WhatsApp 中集中客户服务和自动化，无需增加工具。