23 lines
1.9 KiB
SQL
23 lines
1.9 KiB
SQL
-- 企业微信「客户联系」事件流水表
|
|
-- 用途：
|
|
-- 1) 记录每一次 change_external_contact 推送，用于"今天进来多少人(=add_external_contact 次数)"等精确统计；
|
|
-- 2) 独立于 zyt_qywx_external_contact（会被软删/UPSERT 覆盖），保证统计零误差；
|
|
-- 3) 企微对非 2xx 响应最多重试 3 次，(change_type, user_id, external_userid, event_time) 唯一键保证幂等。
|
|
CREATE TABLE IF NOT EXISTS `zyt_qywx_external_contact_event` (
|
|
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
|
`change_type` varchar(32) NOT NULL DEFAULT '' COMMENT 'change_external_contact 下的子类型，如 add_external_contact/del_external_contact/del_follow_user/transfer_fail 等',
|
|
`user_id` varchar(64) NOT NULL DEFAULT '' COMMENT '企业员工 userid（可能为空）',
|
|
`external_userid` varchar(64) NOT NULL DEFAULT '' COMMENT '外部联系人 external_userid（可能为空，如渠道活码尚未产生客户）',
|
|
`state` varchar(128) NOT NULL DEFAULT '' COMMENT '企微 State（推广渠道自定义参数），用于分渠道统计',
|
|
`fail_reason` varchar(64) NOT NULL DEFAULT '' COMMENT 'transfer_fail 等事件的失败原因',
|
|
`welcome_code` tinyint(1) unsigned NOT NULL DEFAULT 0 COMMENT '是否带欢迎码（1=带；不落 code 原文以免泄漏）',
|
|
`event_time` int(10) unsigned NOT NULL DEFAULT 0 COMMENT '企微 CreateTime（事件发生时间戳，秒）',
|
|
`create_time` int(10) unsigned NOT NULL DEFAULT 0 COMMENT '本地入库时间（秒）',
|
|
`raw` text DEFAULT NULL COMMENT '事件原文 JSON（调试用，可定期清理）',
|
|
PRIMARY KEY (`id`),
|
|
UNIQUE KEY `uk_change_user_ext_time` (`change_type`, `user_id`, `external_userid`, `event_time`),
|
|
KEY `idx_change_time` (`change_type`, `event_time`),
|
|
KEY `idx_event_time` (`event_time`),
|
|
KEY `idx_state` (`state`)
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='企业微信外部联系人事件流水（用于进入计数）';
|