连接 Zendesk

导入客服对话，让人群用客户主动说出的原话来回答。只需管理员在你们自己的 Zendesk 里创建一次只读的 OAuth 客户端。

只有在客服工单里，客户才会不等别人问，就主动说出自己的想法。把工单导进来，人群就能用上这些原话。

Zendesk 的 OAuth 客户端只在单个 Zendesk 实例里有效，所以没有现成的 iMario 公共应用可以直接授权。需要你们 Zendesk 的管理员自己建一个客户端，iMario 用它读取数据，而且只读你选中的内容。整个过程只要两三分钟，也不花钱。

管理员一次性配置

在 Zendesk 里打开 Admin Center → Apps and integrations → APIs → OAuth clients。
点击 Add OAuth client，起一个同事一看就认得出的名字，比如“iMario”。
在 Redirect URLs 里原样粘贴下面这个地址：
```
https://api.imario.ai/api/connections/callback
```

Allowed scopes 可以留空；如果要限制，就一定要包含下面这两项：

权限范围	iMario 能读取的内容
`tickets:read`	工单和工单里的评论，也就是人群要用的那些原话
`users:read`	每条评论是谁写的，这样每段对话才能对应到当时沟通的那位客户

这两个权限范围都是只读的，这个客户端改不了、也删不了 Zendesk 里的任何内容。另外，iMario 不会申请范围宽泛的 read，申请了它，就等于开放你账号下所有的 GET 接口。

iMario 还需要你的 Zendesk 子域名，因为每个 Zendesk 实例都有自己的主机地址。子域名就是 Zendesk 网址的第一段，比如 acme.zendesk.com 的子域名是 acme。

在 Create audience 里点击 Connect a data system，选择 Zendesk。
粘贴第 5 步复制的 Unique identifier 和 Secret，再填上你的 Zendesk subdomain（Zendesk 子域名）。
点击 Connect to Zendesk，在 Zendesk 自己的页面上确认授权。
页面会列出你的工单，显示主题和日期。列表较长时可以先搜索，再勾选要用的工单。
点击 Import。

只读你勾选的工单，每张工单只读评论和评论作者的邮箱地址。这个地址只用作关联字段，绝不会当成回答：客户的投诉正是靠它，才能对应到人群里的同一位客户。如果工单发起人没有登记邮箱地址，这张工单照样会影响人群的说话方式，只是不会归到某一个人名下。

客服人员的回复也会读取，这样对话前后才说得通，但这些回复绝不会算作客户说的话。

Zendesk 页面提示回调地址不匹配。回调地址是逐个字符比对的。检查末尾是不是多了斜杠，再确认客户端的 Redirect URLs 字段里有上面那个地址。

连接时提示“Invalid scope”（权限范围无效）。客户端的 Allowed scopes 设了限制，但没有包含 tickets:read 和 users:read。要么把这两项加上，要么清空这个字段，让客户端可以申请任意权限范围。

导入的对话全都没有客户邮箱地址。查找工单发起人需要 users:read。如果是先建了客户端、后来才加上这个权限范围，就重新连接一次：令牌只带有你授权那一刻已有的权限范围。