企业微信员工个性化欢迎语系统

基于企业微信API的自建应用,实现员工独立配置个性化欢迎语功能

系统功能

API 认证

所有 API 接口需要添加 API 密钥认证,可以通过请求头 X-API-Key 或请求参数 api_key 来实现。

// 使用请求头认证
curl -H "X-API-Key: your_api_key" https://example.com/api/endpoint

// 使用请求参数认证
curl https://example.com/api/endpoint?api_key=your_api_key

API接口文档

测试配置 GET

/api/common.php?action=test_config

测试企业微信API配置是否正确

同步员工信息 GET

/api/sync.php?action=sync_employees

从企业微信同步员工信息到数据库

同步客户信息 GET

/api/sync.php?action=sync_customers&user_id=员工userid

从企业微信同步客户信息到数据库

获取员工列表 GET

/api/common.php?action=employees

获取所有启用状态的员工列表

获取客户列表 GET

/api/common.php?action=customers&employee_id=员工ID&welcome_sent=0&page=1&page_size=20

分页获取客户列表,可按员工和发送状态筛选

获取欢迎语列表 GET

/api/welcome.php?action=list&employee_id=员工ID

获取指定员工的欢迎语配置列表

保存欢迎语 POST

/api/welcome.php?action=save

创建或更新欢迎语配置

请求参数:

字段类型说明
employee_idint员工ID
text_contentstring文字内容
media_typestring媒体类型:text/image/link/miniprogram/video/file
media_idstring企业微信素材media_id
link_titlestring链接标题
link_urlstring链接URL
miniprogram_appidstring小程序AppID
sortint排序值

删除欢迎语 DELETE

/api/welcome.php?action=delete&id=欢迎语ID

删除指定的欢迎语配置

发送欢迎语 POST

/api/welcome.php?action=send

向指定客户发送欢迎语

请求参数:

字段类型说明
employee_idint员工ID
external_useridstring企业微信客户external_userid

批量发送欢迎语 POST

/api/welcome.php?action=batch_send

批量向未发送的客户发送欢迎语

请求参数:

字段类型说明
employee_idint员工ID
limitint每次发送数量(默认100)

欢迎语预览 POST

/api/welcome.php?action=preview

生成欢迎语预览,不实际发送

请求参数:

字段类型说明
employee_idint员工ID

响应示例:

{"success":true,"message":"欢迎语预览生成成功","data":{"welcome_code":"","text":{"content":"欢迎您成为我们的客户!"},"attachments":[{"msgtype":"image","image":{"media_id":"MEDIA_ID"}}]}}

上传媒体文件 POST

/api/common.php?action=upload_media

上传图片、视频等媒体文件到企业微信

请求参数:

字段类型说明
mediafile媒体文件
typestring文件类型:image/video/file

获取发送日志 GET

/api/common.php?action=logs&employee_id=员工ID&page=1&page_size=20

分页获取欢迎语发送日志

响应格式

所有接口返回JSON格式数据:

{
  "success": true/false,
  "message": "操作结果信息",
  "data": { ... }
}