1集成方案概述
AI·定义 LINK THINK提供多种灵活的集成方案，帮助企业将AI员工无缝接入现有系统。无论您使用何种技术栈，都能找到适合的集成方式。
API集成
通过RESTful API进行深度定制集成
提示
如果您不确定选择哪种集成方案，建议先使用Web插件进行快速体验，再根据实际需求进行深度API集成。
2支持的系统类型
我们的AI员工可以与各类企业系统无缝对接：
- OA办公系统：钉钉、企业微信、飞书、泛微、致远等
- ERP系统：SAP、Oracle、用友、金蝶等
- CRM系统：Salesforce、Dynamics、纷享销客等
- HR系统：北森、Moka、薪人薪事等
- 客服系统：智齿、udesk、环信等
- 知识库系统：Confluence、语雀、石墨等
- 企业自建系统：通过API与任何自建系统对接
3API集成指南
3.1 获取API密钥
首先需要在管理后台生成API密钥：
- 登录管理后台，进入"系统设置"-"API管理"
- 点击"生成新密钥"，填写应用名称和描述
- 选择需要的API权限范围
- 保存生成的API Key和Secret（请妥善保管）
3.2 API调用示例
以下是使用Python调用AI员工对话API的示例：
import requests
import json
# API配置
api_key = "your_api_key"
api_secret = "your_api_secret"
base_url = "https://api.aidingyi.cn/v1"
# 请求头
headers = {
"Authorization": f"Bearer {api_key}:{api_secret}",
"Content-Type": "application/json"
}
# 发送消息
response = requests.post(
f"{base_url}/ai-employees/{employee_id}/chat",
headers=headers,
json={
"message": "请帮我查询本月的销售数据",
"session_id": "session_123"
}
)
result = response.json()
print(result["reply"])
3.3 Webhook配置
如需接收AI员工的异步通知（如任务完成、异常告警等），可以配置Webhook：
- 在API管理页面点击"Webhook设置"
- 填写接收通知的URL地址
- 选择需要订阅的事件类型
- 配置签名密钥用于验证请求来源
- 保存并进行测试验证
安全提醒
API密钥具有完全的操作权限，请勿将密钥硬编码在前端代码中或泄露给第三方。建议定期轮换密钥，并设置IP白名单限制访问来源。
4插件集成指南
4.1 Web组件集成
对于Web应用，可以使用我们提供的JavaScript SDK快速集成：
<!-- 引入SDK -->
<script src="https://cdn.aidingyi.cn/sdk/ai-employee-widget.js"></script>
<!-- 初始化AI员工组件 -->
<script>
AIEmployeeWidget.init({
apiKey: 'your_api_key',
employeeId: 'emp_123',
position: 'bottom-right',
theme: 'dark'
});
</script>
4.2 钉钉/企业微信集成
将AI员工添加到钉钉或企业微信工作台：
- 在管理后台选择"应用集成"-"钉钉/企业微信"
- 扫描二维码授权绑定企业账号
- 选择需要集成的AI员工
- 设置应用名称、图标和可见范围
- 发布应用到工作台
4.3 桌面客户端
支持Windows和Mac桌面客户端，可以在系统托盘常驻运行，支持全局快捷键唤醒。
5单点登录（SSO）配置
支持标准SAML 2.0和OAuth 2.0协议，可与企业现有身份认证系统对接：
5.1 SAML集成
- 在管理后台进入"系统设置"-"SSO配置"
- 选择SAML 2.0协议
- 填写IdP元数据URL或上传元数据文件
- 配置属性映射（如email、name、department等）
- 下载SP元数据并提供给IdP管理员
- 启用SSO并进行测试登录
5.2 OAuth集成
支持对接企业微信、钉钉、飞书等OAuth提供商，实现扫码登录。
6常见问题
Q: API调用有频率限制吗？
A: 是的，不同套餐有不同的API调用配额。基础版每分钟100次，专业版每分钟500次，企业版无限制。超出限制会收到429状态码响应。
Q: 集成过程中遇到问题如何获取支持？
A: 我们提供多种技术支持渠道：1）查看开发者文档；2）提交工单获取技术支持；3）预约技术顾问进行一对一指导；4）加入开发者社区交流。
Q: 是否支持私有化部署环境下的集成？
A: 支持。私有化部署提供完全内网环境的API访问，无需连接外网。同时支持与内网系统的深度集成。
Q: 集成后如何测试验证？
A: 建议按照以下步骤验证：1）API连通性测试；2）单点登录测试；3）消息收发测试；4）业务场景端到端测试；5）性能压力测试。