跳到导航

Trello

使用 Webhook 工具将来电者请求转为 Trello 卡片。

当来电者要求回电、报价或其他需要团队跟进的事项时,接待员可以将卡片添加到 Trello 列表中。Webhook 工具会通过 Trello 的 REST API 创建卡片。

开始前

1

获取 API 密钥

前往 Power-Up 管理门户,为工作区创建一个 Power-Up(名称无关紧要),打开其 Trello Auth 标签页,然后选择 生成新的 API 密钥。

2

生成令牌

选择 API 密钥旁的 Token 链接,或在浏览器中打开以下 URL,并将 API_KEY 替换为 API 密钥:

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY

选择 允许 并复制令牌。它可以读取和更改你有权限访问的所有看板,因此建议使用仅加入所需看板的账户生成令牌。

3

查找列表 ID

在浏览器中打开看板,在其 URL 末尾添加 .json,然后加载页面。搜索列表名称;旁边的 id 值就是列表 ID。

创建 Webhook 工具

前往 集成,选择 添加集成,然后选择 Webhook 工具。

字段值
名称create_trello_card
描述”每当你承诺会跟进来电者,或来电者提出需要团队处理的事项时,为团队创建卡片。“
方法POST
URLhttps://api.trello.com/1/cards?idList=LIST_ID
请求标头Authorization:OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"
正文参数name(字符串,必填):「包含来电者姓名及其需求的简短标题,例如:致电 Jane Doe 跟进报价。」
desc(字符串,必填):「来电者的姓名、电话号码及请求详情。」
分配给智能体接待员

请直接在 URL 字段中输入 ?idList=LIST_ID,并替换为列表 ID。不要将 idList 添加为查询参数:查询参数由 AI 填充,而 URL 中的文本会完全按原样发送。

Trello 也接受在 URL 中使用密钥和令牌,例如 &key=API_KEY&token=TOKEN。这同样有效, 但使用标头可避免将它们放入 URL 中。如果将它们放在 URL 里,请将整个 URL 视为机密。

选择 启用,然后通过要求回电来测试接待员。卡片会出现在列表底部。

故障排除

问题检查项
Trello 返回 401检查标头:密钥和令牌都必须用双引号括起,并以逗号和空格分隔。如果令牌已被撤销,请重新生成。
invalid value for idListURL 中的列表 ID 错误。请使用列表的 id,而不是看板的。
Trello 返回 404 或无访问权限令牌对应的用户必须是该看板成员。
接待员从不创建卡片在工具描述中明确应创建卡片的情况。