API 与编程智能体集成

用你的代码构建,或让你的编程代理来做。

从你的应用程序或通过连接到 Bird 的代理构建原生 Apple 对话。通过同一业务身份、权限和服务上下文创建内容、连接旅程并管理客户交互。

探索 Apple Messages for Business

一次完整的原生交互

示例

01 · 商户

已获批准的企业身份

02 · 会话

客户上下文

03 · 原生消息

有用内容

04 · 响应

关联操作

虚构的集成与编程智能体工作流。示例控件不会发布真实旅程。请参阅 API 规范获取确切的字段和权限。

连接到你的应用程序的原生体验

让对话紧贴业务操作。

你的应用程序知道哪些预约可用以及预订何时确认。Bird 将该业务逻辑连接到 Apple Messages 对话:发送原生内容、接收客户回复并返回其所选操作的结果。

使用你的 API 客户端或通过 Bird 的 MCP 服务器连接的编程智能体进行构建。使用已发布的操作规范和限定范围的工作区权限来检查企业、准备内容并将客户旅程连接到你的应用程序。

阅读集成指南
预订所选工作室预约并确认记录的结果。
关联的请求上下文
渠道上下文企业 + 对话
客户回复所选预约
应用结果已确认的预订参考号
业务结果已验证旅程已继续
示意性客户旅程和业务记录。

构建完整的交互流程。

将集成视为一次有结果的对话。在原生回复、应用请求和客户确认之间保持引用完整。

01

确定对应的企业与对话

使用目标工作区和已获 Apple 批准的企业,并将凭证权限限定到所需操作。常规回复使用现有对话的 Apple 身份;以电话号码寻址的邀请则遵循单独获批的接口规范。

02

发送带有预定义回复的原生内容

选择内容类型和预期回复。保留消息、请求和对话引用,以便列表选择、表单提交或时间选择能够匹配到预期的下一步。

03

验证并执行业务操作

根据当前业务数据和客户权限检查回复。使用你的预订、商务或身份应用来执行操作,并遵循该应用的授权和恢复行为。

04

返回已记录的结果

关联结果并继续对话。如果某个观察重复或延迟到达,将其与现有操作进行对账;将已接受的发送与客户正在等待的业务结果区分开。

为编程代理提供同样清晰的契约。

使用真实上下文检查和准备

将代理连接到 Bird 的 MCP 服务器,并提供相关的集成指南、工作区和脱敏后的业务模型。让代理在准备内容或变更之前先检查现有配置,并将凭证保留在执行环境中。

发布前审查变更

检查确切的原生消息、旅程分支和关联操作。测试一次成功的交互以及一个明显不同的拒绝或不确定结果,然后使用团队批准的权限发布审查通过的版本。

API 与编程智能体集成常见问题

能否将 Apple 网关请求直接复制到 Bird 中?
使用 Bird 的现行契约,它保留了原生语义,同时应用自身的命名、寻址和认证规范。
编程代理能否构建和运行该体验?
将编程代理连接到 Bird 的 MCP 工具,以检查工作区、准备原生内容并配合旅程使用。对发布和客户操作应用相同的权限、审核和确认流程。
编程代理能否阅读产品指南?
结合 Markdown 替代格式和关联指南使用权威的 API 描述。营销示例不能替代操作契约。
首次集成测试应验证什么?
在真实目标设备上验证已批准的消息交互、返回的输入、业务结果,以及失败或不确定响应的恢复场景。

付诸实践。

继续查阅此主题的文档、指南和示例。资源为英文。

获取实施简报

将对话关联到实际业务成果。

与 Apple Messages 专员一起审核你的应用、许可操作和测试计划。在上线前验证回复和异常恢复路径。

从一个渠道开始。
准备好后,再添加其他渠道。

测试 API 密钥即刻可用。添加支付方式并验证发送者身份后,即可解锁生产环境。

正在使用 Claude Code、Cursor 或 Codex?复制一条设置提示,您的智能代理即可自动安装 Bird CLI 和相关技能。选择您的工具:

Cursor