要配置 Papo（https://papo.global/）的 Capitão 实时查询订单状态，请使用通过 HTTP 连接的自定义工具（Tool）。它将助手连接到你的 ERP、电商或 CRM 端点，并让 AI 解读客户消息、将订单号发送到外部系统，并在 WhatsApp 对话期间返回状态。
通过此配置，Capitão 不再只是回答问题的助手，而是开始执行实际操作。客户可以发送“我的订单 12345 在哪里？”，并收到自动回复，例如“订单运输中”，无需人工介入。这可以减少排队、加快服务速度，并让团队腾出时间处理复杂案例。
配置摘要
| 步骤 | 要做什么 | 说明 |
|---|---|---|
| 1. 访问 Capitão | 在 Papo 平台打开助手设置。 | 菜单的确切名称可能有所不同。 |
| 2. 创建自定义工具 | 使用 HTTP 类型将 Capitão 连接到带 API 的外部系统。 | 需要具备 API 和 HTTP 请求的技术知识。 |
| 3. 定义端点 | 填写你的 ERP、电商或 CRM 的 API URL。 | 示例：https://api.meusistema.com/v1/pedidos。 |
| 4. 配置方法和身份验证 | 使用 GET 获取数据，并包含安全请求头，例如身份验证令牌。 | 示例：Authorization: Bearer sua_chave_secreta。 |
| 5. 发送订单号 | 允许 Capitão 在对话中使用客户提供的信息。 | 操作会根据所提供的订单动态变化。 |
| 6. 关联到 WhatsApp | 在 WhatsApp 收件箱中启用助手。 | 查询将在服务过程中生效。 |
Capitão 如何查询状态
流程是一个将客户消息连接到具体操作的循环：
- 客户询问订单： 发送类似“我的订单 12345 到哪了？”的消息。
- Capitão 理解意图： 根据已配置工具的说明和描述，它识别出应查询状态。
- 工具被触发： 助手将号码“12345”发送到你的外部系统端点。
- 系统返回状态： API 返回结果，例如“订单运输中”或“订单已送达”。
- Capitão 回复客户： AI 使用该返回结果，在 WhatsApp 中组织自然且完整的回复。
整个过程实时发生，无需人工客服复制订单号并打开另一个系统。
使用 HTTP 自定义工具的前提条件
配置之前，重要的是具备：
- 已创建 Capitão 助手：在 Papo 平台中，已定义名称和描述。
- 有可用 API 的外部系统：例如 ERP、CRM 或电商平台。
- 端点 URL：将调用它来查询订单。
- 身份验证凭据：例如 API 密钥或访问令牌，以确保请求安全。
- API 和 HTTP 请求知识：因为自定义工具的配置属于高级操作。
如果你的系统没有 API，或者不知道它接受哪些数据，技术细节应与开发团队或供应商文档确认。
用于订单的原生工具与自定义工具
Papo 为 Capitão 提供两种工具：
| 类型 | 描述 | 使用示例 | 技术知识 |
|---|---|---|---|
| 原生 | 平台中预配置且可直接使用的集成。 | 在 Google 日历中安排演示。 | 低，只需启用并连接账户。 |
| 自定义（HTTP） | 连接到外部系统或 Papo API 的自定义操作。 | 查询公司电商中的订单状态。 | 高级，需要 API 和 HTTP 请求。 |
要实时查询订单状态，最常见的方式是 HTTP 自定义工具，因为订单通常位于公司自己的系统中。没有适用于任何 ERP 或电商的自动原生集成；每个系统都需要通过相应端点进行连接。
为订单状态配置自定义工具
启用订单查询的概念流程遵循清晰逻辑：
- 访问助手设置： 在 Papo 面板中，打开管理工具的 Capitão 配置区域。
- 创建 HTTP 自定义类型工具： 选择允许通过 API 连接到外部系统的选项。
- 填写请求数据： 填写端点 URL、HTTP 方法（使用 GET 获取数据）以及身份验证请求头，例如
Authorization: Bearer sua_chave_secreta。 - 定义如何发送订单号： 工具可以使用对话中的数据来让操作动态化。这样，当客户提供订单 12345 时，Capitão 会在调用中发送该值。
- 清楚描述何时应使用该工具： Capitão 会根据你配置的说明和描述选择合适的工具。加入消息示例，例如“查询状态”“我的订单在哪里”或“跟踪订单”。
- 将助手关联到收件箱： 在 WhatsApp 或连接到 Papo 的其他渠道的收件箱中启用 Capitão。此后，它将在对话中回复状态请求。
平台内屏幕和按钮的确切名称可能有所不同。如果对某个字段的位置有疑问，请查阅帮助中心或 Papo 支持。
这种自动化何时有意义
配置实时订单状态查询对以下运营很有用：
- 在 WhatsApp 收到大量重复的订单问题。
- 通过电商销售或处理交付期限。
- 希望减少售后对话中的首次响应时间。
- 需要让团队腾出时间处理需要人工分析的案例，例如换货、退款或投诉。
- 已经拥有带订单查询 API 的外部系统。
如果你的运营还没有订单 API，可能无法立即实现完整自定义。在这种情况下，值得评估 Papo 的原生工具是否能满足服务流程中的另一个环节，例如在 Google 日历中安排演示。
常见问题
配置状态查询需要会编程吗？
是的，对于 HTTP 自定义工具，需要具备 API 和 HTTP 请求的高级知识。原生工具配置更简单，但不会自动覆盖所有外部系统。
Capitão 能查询多个系统吗？
可以。你可以配置多个自定义工具，让 Capitão 与不同 API 通信，例如 ERP、CRM 或电商平台。
如何确保查询安全？
使用身份验证请求头，例如访问令牌，以确保请求安全且已授权。例如，Authorization: Bearer sua_chave_secreta。不要公开分享密钥，并且只授权访问必要的端点。
可以在 WhatsApp 中启用前测试吗？
可以。理想情况下，在收件箱中启用助手之前，先用外部测试工具验证 API 调用，以避免向客户返回错误回复。
如果外部系统返回错误会怎样？
Capitão 只能根据 API 返回结果进行回复。如果端点宕机或返回错误，回复可能不包含状态。因此，监控集成系统的可用性很重要。
另请阅读：
将 WhatsApp、Instagram、电子邮件和 SMS 集中到一个收件箱，由 Papo 的 AI 在 2 秒内回复。