项目简介
飞书AWS技术支持工具是基于飞书企业通信工具的解决方案,方便用户与AWS售后工程师进行快捷文字沟通。飞书用户能够通过简单的机器人互动,向AWS售后工程师团队提交支持案例、更新案例内容,并准实时接收后台工程师的更新。
项目的主要特性和功能
- 便捷沟通:用户可通过飞书机器人与AWS工程师快速文字交流,实现支持案例的提交与更新。
- 服务选择:支持用户按需选择不同的AWS服务进行问题咨询。
- 实时更新:机器人能实时更新AWS支持案例状态与工程师回复,并推送到指定飞书群聊。
- 多语言支持:支持英文、中文、日文、韩文等多语言进行案例提交。
- 自定义配置:用户可指定机器人支持的AWS账号、服务等级及服务列表,满足个性化需求。
安装使用步骤
安装部署
- AWS SAM安装:
- 根据官方文档在本地环境部署SAM CLI。
- 部署飞书AWS技术支持机器人环境:
cd larkbot sam build sam deploy --config-file samconfig.toml --resolve-s3 --stack-name <stack-name> --profile <AWS config profile> --region <AWS region>
- 飞书开放平台界面设定:
- 创建自定义企业应用,设定应用名称、描述及飞书图标,启动机器人功能。
- 设定消息卡片请求网址,将SAM部署完成后返回的LarkBot的API Gateway的Endpoint地址填入。
- 获取当前机器人小程序的App ID和App Secret,并更新到DynamoDB中bot_config表对应的机器人配置。
- 开通必要权限,如获取与更新群组信息、读取群消息等。
- 添加事件订阅请求网址及内容,再次填入API Gateway的Endpoint地址,并选择接收消息事件。
- 机器人在飞书开放平台发版时,需选择员工可用范围。
- 设定机器人Profile:
使用方法
- 开支持案例:
- 可在和机器人的1:1聊天中输入帮助关键字获取开支持案例相关帮助(可选)。
- 输入开工单关键字及案例题目,用空格分割。
- 在弹出小卡片中选择AWS账号、服务类型及严重级别。
- 输入内容关键字及案例内容,用空格分隔。
- 完成信息提交后,机器人会创建以支持案例ID + 案例题目命名的飞书群聊。若需创建测试案例,在问题中以TEST_CASE_Please_ignore开头,后台工程师会忽略。
- 更新支持案例: 在机器人创建的工单群里输入文字或添加附件即可更新工单内容。若网络不佳可能丢失消息,需重新发送。
- 后台更新自动推送: 飞书AWS技术支持机器人后端逻辑会按eventbridge的rule执行时间间隔更新支持案例内容,默认间隔为2分钟,可修改参数调整。
- 多机器人配置: 可通过创建多个机器人并为不同机器人指定不同配置文件实现个性化配置,通过lambda函数环境变量指定CFG_KEY,并在config_bot表中创建对应记录。
- 提交中国区案例支持:
若需向AWS宁夏及北京地区支持团队提交案例,需增加lambda环境变量
--environment Variables={SUPPORT_REGION=cn}
,同时删除CASE_LANGUAGE环境变量。 - 工单系统多语言支持:
可通过环境变量控制工单语言选择,如
--environment Variables={CASE_LANGUAGE=ja}
,若未指定则默认英文队列。指定SUPPORT_REGION=cn时需删除CASE_LANGUAGE环境变量。
成本说明
使用成本根据case数量、刷新频率决定,正常free tier可覆盖,成本为0,需关注Cloudwatch log的历史日志信息及DynamoDB中的历史CASE信息。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】