Collection
REST API Actions
6 articles
REST API 操作的认证设置
```html 摘要 本文档介绍了如何在 Astra 中为 REST API 操作配置身份验证。它涵盖了支持的身份验证方法、何时使用它们以及如何正确设置它们,以便您的 API 请求能够被接受。 说明 身份验证告知外部系统来自 Astra 的请求是允许的。在设置 REST API 操作时,您可以根据 API 的要求选择一种支持的身份验证方法。 Astra 目前支持以下身份验证选项: - API 密钥身份验证 - 基本身份验证 - 无身份验证 API 密钥身份验证 这是现代 API 最常用的身份验证方法。 使用 API 密钥身份验证时,您会在请求头中发送一个…
1 min read · Updated Oct 28, 2026
什么是 REST API 操作?
摘要 REST API 操作允许您的 Astra AI 代理在对话中发生特定事件时自动将数据发送到另一个系统。本文档将解释什么是 REST API 操作,它如何简单工作,以及您可能何时想要使用它。 说明 REST API 操作允许您的 AI 代理在恰当的时机将信息发送到外部系统,无需任何手动操作。 简单来说,它通过在对话中发生特定事件时安全地发送数据,帮助 Astra 与其他工具“交谈”。这可以保持您的系统同步,并消除了手动导出、复制粘贴或后续跟进的需要。 REST 是 Representational State Transfer 的缩写。REST A…
1 min read · Updated Oct 28, 2026
可用事件类型:详细指南
摘要 本文档将详细介绍 Wati 中 REST API 操作可用的不同事件类型。您将了解每个事件的触发时机、可发送的数据以及如何正确使用它们——尤其是在收集反馈、表单数据或潜在客户信息时。 说明 基于事件的 REST API 操作在会话中发生特定事件时会自动运行。每种事件类型在发送数据(参数)方面都有不同的行为。 了解这些差异有助于您选择正确的事件并避免配置问题。 1. 赞成/反对事件 触发时机 当用户在聊天界面点击反馈按钮(👍 或 👎)时,将触发此事件。 参数行为 - 仅支持静态(固定)参数 - 无法传递动态用户数据 这意味着 API 请求中的所有值都…
2 min read · Updated Oct 28, 2026
如何排查 REST API 操作
摘要 本文档可帮助您排查使用 Astra 中的 REST API 操作时遇到的常见问题。内容涵盖了诸如缺少表单参数、潜在客户数据限制、身份验证错误等常见问题,以及重要的安全注意事项,以确保您的集成可靠运行。 说明 表单已提交:参数未传递 问题 自定义表单提交后,您的 REST API 接收到的是空值或缺失值。 原因 这通常发生在 REST API 配置中使用的占位符与表单字段名称不完全匹配时。 匹配是区分大小写的,并且基于占位符的后缀(最后一个 . 之后的部分)。 解决方案 确保占位符后缀与您的表单字段名称完全匹配。 示例: - 表单字段 first_n…
1 min read · Updated Oct 28, 2026
如何设置 REST API 操作
摘要 本文将指导您如何在 Wati 中设置 REST API 操作。您将了解如何选择正确的触发器、在需要时选择事件类型,以及如何正确将操作添加到您的 AI 代理的指令中,使其按预期工作。 注意: REST API 操作仅适用于使用 Business 套餐的 Astra 客户。 说明 REST API 操作只有在配置正确并添加到您的 AI 代理的指令中时才能正常工作。设置过程包含 3 个主要步骤: - 选择操作的触发方式 - 选择事件类型(如适用) - 将 REST API 操作添加到您的 AI 代理的指令中 请按照以下步骤完成设置。 步骤 1:选择触发器…
1 min read · Updated Oct 28, 2026
如何配置属性及REST Action API负载
摘要 本指南说明REST API操作属性在Astra中如何工作,以及它们在Astra代理中如何使用。属性作为占位符,用于存储和传递指令与操作之间的数据。 您将了解不同类型属性的行为,以及在配置REST API(表述性状态转移)操作时如何正确使用它们。 操作说明 什么是属性 在Astra中,属性是一个存储值的占位符。它使您的代理能够在执行过程中动态使用数据。 例如,像first name或last name这样的属性可以存储客户详细信息,并在响应或操作中重复使用。 关键点 - 属性像变量一样在代理内部工作 - 它们可以在指令和操作中使用 - 在指令中,属性…
1 min read · Updated Oct 28, 2026