集成 Apple Messages 客户旅程
通过 Bird 当前的接口规范连接企业身份、原生内容、客户回复和业务结果。
前提条件
准备 Bird 工作区、已获 Apple 批准的企业、限定范围的凭据和已授权的测试会话。联系 Apple Messages 专员以确认工作区访问权限,并获取适用于集成的受支持操作规范。将编程智能体连接到 Bird 的 MCP 服务器,或使用应用的 API 客户端,两者均须遵循相同的工作区和企业权限。
1. 映射两条寻址路径
普通回复使用当前打开会话的 Apple 身份。邀请使用单独的、已批准的电话号码寻址操作,并需要明确的选择加入。在实现任一路径之前,请先阅读该操作的实际字段和受众。
2. 准备原生交换
选择一种受支持的内容类型和一个具体的预期响应。在应用中保留企业、会话、请求和消息的引用关系。不要在公开示例中暴露凭据和私密消息内容。
3. 验证设备和响应
通过已批准的测试路径发送,检查原生渲染效果并返回应答。将该输入与原始请求关联,并在执行业务操作之前进行验证。
4. 处理异步结果
Apple 网关接受的发送会被记录为已发送;这不代表设备送达或已读回执。将消息处理与订单、预订或身份结果分开。在不假设统一投递顺序或提供商去重的情况下,处理重复或乱序的事件。根据状态说明来决定哪个事件可以推进客户的任务。
5. 使用编程代理构建和审查
通过 Bird MCP 服务器连接编程智能体。要求它在提出变更建议前检查工作区、企业和现有内容。提供 Apple Messages 操作规范、本指南以及隐去敏感信息的应用模型。
让代理准备原生消息和旅程分支,然后测试一个成功的交换以及一个明显不同的拒绝或不确定响应场景。在发布之前审查确切的内容、关联操作和权限。对客户联系和有重大影响的业务操作要求确认。在重试之前检查原始操作。
在边界处验证集成
使用原生预约选择作为测试交互。追踪已获批准的企业和会话、出站请求、客户选择的响应以及已确认的预约。这些是在应用中需要关联的概念记录;请使用工作区可用接口规范中的实际字段名和操作结构。
| 测试用例 | 操作 | 预期结果 |
|---|---|---|
| 再次观察到相同的客户响应 | 将其与已记录的请求和应用程序操作进行比对解析。 | 重复的事件不会创建另一个预订。 |
| 应用程序拒绝了业务操作 | 返回有用的拒绝说明或替代方案,不改变该操作的结果。 | 不向客户告知预订或购买已成功。 |
| 代理准备旅程修订 | 在发布之前检查其内容、关联操作和生效权限。 | 发布的体验与你的团队审查过的修订一致。 |
故障排除
如果操作被拒绝,请验证工作区、企业获批状态和账户权限。如果消息已被接受但客户任务失败,请分别检查设备渲染和关联的业务系统。使用已发布的确切 API 操作,不要凭猜测改编其他服务商的方法名称。
后续步骤
相关资源
继续查阅此主题的文档、指南和示例。资源为英文。