企业微信scrm源码开发-渠道活码数据库表设计

CREATE TABLE `wxwork_channel` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `name` varchar(100) NOT NULL DEFAULT '' COMMENT '活码名称',
  `config_id` varchar(64) NOT NULL DEFAULT '' COMMENT '企微返回的配置ID',
  `type` tinyint(1) NOT NULL DEFAULT '1' COMMENT '联系方式类型：1-单人 2-多人',
  `user` varchar(2000) DEFAULT '' COMMENT '使用该联系方式的用户userID列表，在type为1时为必填，且只能有一个,|分割',
  `party` varchar(1000) DEFAULT '' COMMENT '使用该联系方式的部门id列表，只在type为2时有效，|分割',
  `scene` tinyint(1) NOT NULL DEFAULT '2' COMMENT '场景：1-小程序 2-二维码',
  `state_param` varchar(32) NOT NULL DEFAULT '' COMMENT '自定义state参数，用于渠道追踪',
  `skip_verify` tinyint(1) NOT NULL DEFAULT '1' COMMENT '是否无需验证',
  `qr_code_url` varchar(500) DEFAULT NULL COMMENT '二维码图片URL',
  `remark` varchar(200) DEFAULT NULL COMMENT '备注信息',
  `is_temp` tinyint(1) NOT NULL DEFAULT '0' COMMENT '是否临时会话',
  `expires_in` int(11) DEFAULT NULL COMMENT '临时会话二维码有效期(秒)',
  `chat_expires_in` int(11) DEFAULT NULL COMMENT '临时会话有效期，以秒为单位。该参数仅在is_temp为true时有效，默认为添加好友后24小时，最多为14天',
  `unionid` varchar(64) DEFAULT '' COMMENT '可临时会话的客户unionid',
  `status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '状态：0-禁用 1-启用',
  `total_adds` int(11) NOT NULL DEFAULT '0' COMMENT '总添加客户数',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_config_id` (`config_id`),
  UNIQUE KEY `uk_state` (`state_param`),
  KEY `idx_status` (`status`)
) ENGINE=InnoDB COMMENT='渠道活码表';

-- 创建记录即完成配置
INSERT INTO wxwork_channel (user, party, state_param) 
VALUES ('zhangsan|lisi|wangwu', '10|20', 'channel_001');

-- 读取后直接调用API
$data = [
    'user' => explode('|', $record['user']),
    'state' => $record['state_param']
];
$wechatApi->addContactWay($data);

UNIQUE KEY `uk_state` (`state_param`)  -- 确保每个渠道标识唯一

`status` TINYINT DEFAULT 1  -- 启用/禁用状态管理
`config_id` UNIQUE         -- 企微配置ID唯一性保证

`total_adds` INT DEFAULT 0  -- 只记录总添加数

`is_temp`, `expires_in`, `chat_expires_in`, `unionid`