Zendesk V2框架私有应用迁移：客户端获取工单邮箱问题

我帮你梳理一下在Zendesk V2 IFrame应用中获取工单邮箱的正确方式，完全不需要页面刷新，同时解决ZAFClient.init的问题：

首先，核心思路是利用Zendesk Apps Framework (ZAF)的客户端API直接从Zendesk上下文拉取工单数据，全程在客户端异步完成，不会触发页面刷新。下面是具体步骤和代码示例：

1. 确保ZAF SDK已引入 #

你的IFrame页面需要加载ZAF SDK脚本，这样才能和Zendesk主应用通信。在页面的<head>或<body>末尾添加：

<script src="https://assets.zendesk.com/apps/sdk/2.0/zaf_sdk.min.js"></script>

2. 安全初始化ZAFClient（避免刷新后异常） #

为了防止页面刷新后ZAFClient.init重复执行导致的问题，我们把初始化逻辑绑定到页面的DOMContentLoaded事件上，确保只在页面首次加载时执行一次：

document.addEventListener('DOMContentLoaded', function() {
  // 初始化ZAF客户端，建立和Zendesk主应用的连接
  const client = ZAFClient.init();

  // 验证连接是否成功（可选）
  client.on('app.registered', function(appData) {
    console.log('应用已注册，上下文数据:', appData);
  });
});

3. 获取工单请求者邮箱 #

在初始化完成后，使用client.get()方法异步获取工单的请求者邮箱，这个操作完全不会刷新页面：

document.addEventListener('DOMContentLoaded', function() {
  const client = ZAFClient.init();

  // 获取工单请求者邮箱
  client.get('ticket.requester.email')
    .then(function(data) {
      const requesterEmail = data['ticket.requester.email'];
      // 在这里处理邮箱，比如展示到页面上
      console.log('工单请求者邮箱:', requesterEmail);
      document.getElementById('requester-email').textContent = `请求者邮箱: ${requesterEmail}`;
    })
    .catch(function(error) {
      console.error('获取邮箱失败:', error);
    });

  // 可选：监听工单切换时的邮箱变化
  client.subscribe('ticket.requester.email', function(newEmail) {
    console.log('工单已切换，新邮箱:', newEmail);
    document.getElementById('requester-email').textContent = `请求者邮箱: ${newEmail}`;
  });
});

4. 配置Manifest权限 #

别忘了在你的manifest.json中添加对应的权限范围，否则ZAF API会返回权限错误：

{
  "name": "你的应用名称",
  "version": "1.0.0",
  "defaultLocale": "en",
  "requirements": {
    "scopes": ["ticket.requester.email"]
  },
  "locations": {
    // 你的应用位置配置
  }
}

关键注意事项 #

• 禁止页面刷新：所有数据交互都通过ZAF API完成，不要使用window.location.reload()或跳转链接，保持IFrame页面的状态稳定。
• 单次初始化：通过DOMContentLoaded绑定初始化逻辑，避免重复调用ZAFClient.init()导致的连接异常。
• 异步处理：ZAF API都是异步的，记得用.then()或async/await处理返回结果，不要阻塞页面渲染。

这样就能在不刷新页面的前提下，稳定获取工单的邮箱地址，同时避免ZAFClient.init的问题。

内容的提问来源于stack exchange，提问作者JohnSmith82