跳转到主要内容
Meta Business Agent 是一个由 Meta 托管的 AI Agent,能够利用您配置的业务信息、知识、技能和工具来回复 WhatsApp 客户消息。YCloud 通过 YCloud REST API 提供 Meta Business Agent 生命周期管理,并代表您提供 Meta 凭证。
Meta Business Agent 是一项处于早期访问阶段(early-access)的 Meta 产品。其可用性、校验规则和运行时行为可能会独立于 YCloud 发生变更。请始终为您计划使用的电话号码调用 Check Eligibility 端点。

API 基础知识

YCloud 会根据您的 API Key 解析出租户和 Meta 访问令牌。请勿在这些请求中发送 Meta 访问令牌。

推荐的生命周期

请按顺序遵循“构建与启动”指南。它们将各个 API 资源串联成一个端到端的上线流程。
  1. 准备并检查资格。
  2. 在受限的测试状态下接入并配置 Agent。
  3. 测试和评估单轮、多轮及代表性业务场景。
  4. 从白名单收件人安全逐步推向全部受众。
  5. 运营已上线的 Agent 并排查故障。

工作流涵盖的资源

每个 API 参考目录都有自己的落地页,并提供指向该领域每个端点的链接。 本版本介绍了 62 个 REST 操作。通过 API 创建的 Agent 还可以发出 回显和转接 Webhook 事件。

归属与隔离

除资格检查外,限定在电话号码范围内的操作都需要由同一 YCloud 租户拥有的处于活动状态的 Public API Agent 绑定。当绑定缺失、属于其他租户或通过不兼容的来源创建时,YCloud 会返回 404。这可防止某个租户或集成界面访问另一个 Agent。