要创建用于查询运费报价的 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 如何查询运费
流程把客户的常见问题连接到实时计算：
- 客户请求报价： 发送类似“到 CEP 04123‑000 的运费是多少？”的消息。
- Capitão 解读意图： 根据工具说明和描述，它识别出应使用运费查询 Tool。
- 触发工具： 助手把从对话中提取的值（CEP、商品重量等）发送到承运商端点。
- API 返回金额和时效： 外部系统返回包含可用运费选项的 JSON。
- 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
启用此自动化的概念流程遵循清晰逻辑，无需记住屏幕或按钮名称：
- 访问助手设置： 在 Papo 面板中，前往管理工具所在的 Capitão 配置区域。
- 创建自定义 HTTP 类型的工具： 选择允许通过 API 连接外部系统的选项。
- 填写请求数据： 填写承运商端点 URL、HTTP 方法（通常是 POST，因为你发送 CEP 并接收计算结果）以及认证请求头，例如
Authorization: Bearer sua_chave。 - 定义动态参数： 最大优势是 Capitão 可以使用客户在对话中提供的信息。你可以配置工具发送消息中出现的 CEP、商品默认重量或包裹尺寸。工具会自动解读这些值。
- 指导 Capitão 如何回复： 在工具描述或助手指南中，你可以引导 AI 以友好的方式呈现金额和时效，例如“您到 CEP … 的运费为 R$ …，预计 … 送达”。
- 将助手关联到收件箱： 确保 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 网站。
另请阅读
用 AI 在 WhatsApp 中集中客户服务和自动化，无需增加工具。