Compare commits

..

18 Commits

Author SHA1 Message Date
ed5181b382 chore:电话按钮客服按钮背景白色圈改成正圆 2025-12-19 17:18:36 +08:00
95375d5476 chore:实现后台控制哪个客服,H5可以正常切换客服 2025-12-19 17:07:57 +08:00
b34003e2c0 chore:修改客服 2025-12-19 14:05:48 +08:00
3a455bd644 chore:合并成一个客服按钮 2025-12-19 11:59:52 +08:00
8103f4c897 chore:电话按钮可以点击了 2025-12-19 09:49:58 +08:00
0066a46037 chore:调整样式,删除多余的电话按钮 2025-12-19 08:46:14 +08:00
0b62de8c6b chore:正常运行 2025-12-18 18:31:10 +08:00
9097658782 chore:微信小程序假的流聊天 2025-12-18 15:20:00 +08:00
ca74d4f8e5 chore: 要明确集成微信及支付宝原生客服 2025-12-17 09:19:19 +08:00
d9c9599cb2 chore: 集成统一客服服务 2025-12-16 16:54:39 +08:00
142a97d65c revert: pages/contact/contact.vue 回退到最初状态 2025-12-16 15:52:18 +08:00
b945583857 chore: 优化公共端都支持打开企业微信客服的方法 2025-12-16 15:41:15 +08:00
88debacf8c chore: 使用全局的wxworkConfig配置作为参数 2025-12-16 14:41:45 +08:00
9d12b02463 chore: 将wxworkConfig放到全局配置中 2025-12-16 14:41:15 +08:00
23e81114e9 chore: 后端init接口数据为wxwork_config 2025-12-16 10:54:57 +08:00
08583aa8aa chore: 企业微信客服组件完全独立 2025-12-15 15:04:45 +08:00
5e536afeae feat: 新增打开企业微信客服组件 2025-12-15 14:26:01 +08:00
1854a85394 chore: update comments 2025-11-28 17:38:35 +08:00
17 changed files with 4027 additions and 2360 deletions

View File

@@ -98,6 +98,11 @@
if (uni.getStorageSync('servicerConfig')) {
this.$store.commit('setServicerConfig', uni.getStorageSync('servicerConfig'));
}
// 企业微信配置
if (uni.getStorageSync('wxworkConfig')) {
this.$store.commit('setWxworkConfig', uni.getStorageSync('wxworkConfig'));
}
// 版权信息
if (uni.getStorageSync('copyright')) {

View File

@@ -1,10 +1,11 @@
import Config from './config.js'
import http from './http.js'
import store from '@/store/index.js'
let currentConversationId = null;
const CONVERSATION_KEY = 'ai_conversation_id';
// 初始化时从本地读取
// 初始化时从本地读取会话ID
try {
const saved = uni.getStorageSync(CONVERSATION_KEY);
if (saved) {
@@ -13,16 +14,14 @@ try {
} catch (e) {
console.warn('读取会话ID失败:', e);
}
export default {
/**
* 发送消息到Dify API
* @param {string} message 用户消息内容
* @param {Object} options 配置选项
* @returns {Promise}
* 发送普通消息blocking 模式)
*/
async sendMessage(message, options = {}) {
try {
const aiConfig = store.getters.globalAIKefuConfig
const aiConfig = store.getters.globalAIKefuConfig;
const params = {
url: '/api/kefu/chat',
data: {
@@ -30,225 +29,90 @@ export default {
stream: false,
inputs: {},
query: message,
response_mode: options.stream ? 'streaming' : 'blocking',
response_mode: 'blocking', // 强制 blocking
user: store.state.memberInfo?.id || 'anonymous',
conversation_id: this.getConversationId() || ''
conversation_id: this.getConversationId() || ''
},
header: {
'Content-Type': 'application/json'
}
}
console.log('Sending request to:', params.url);
};
console.log('Sending blocking request to:', params.url);
console.log('Request data:', params.data);
const response = await http.sendRequest({
...params,
async: false
})
const result = this.handleResponse(response, options);
if (result.conversationId) {
this.setConversationId(result.conversationId);
}
return result;
} catch (error) {
console.error('Dify API请求失败:', error)
throw new Error('AI服务暂时不可用请稍后重试')
}
},
});
const result = this.handleResponse(response);
if (result.conversationId) {
this.setConversationId(result.conversationId);
}
return result;
} catch (error) {
console.error('Dify API请求失败:', error);
throw new Error('AI服务暂时不可用请稍后重试');
}
},
/**
* 流式消息处理
* 流式消息入口(自动适配平台)
*/
async sendStreamMessage(message, onChunk, onComplete) {
// #ifdef MP-WEIXIN
// 微信小程序:降级为普通请求 + 前端打字模拟
try {
return this.sendHttpStream(message, onChunk, onComplete)
} catch (error) {
console.error('流式消息发送失败:', error)
throw error
}
},
const result = await this.sendMessage(message);
const content = result.content || '';
const conversationId = result.conversationId || '';
/**
* EventSource 流式聊天
*/
chatWithEventSource(message, conversationId = '', onMessage, onComplete, onError) {
if (window.currentEventSource) {
window.currentEventSource.close();
}
const params = new URLSearchParams({
uniacid: store.state.uniacid || '1',
user_id: store.state.memberInfo?.id || '123456',
query: message,
conversation_id: conversationId || '',
stream: 'true'
});
const url = `/api/kefu/chat?${params.toString()}`;
try {
const eventSource = new EventSource(url);
window.currentEventSource = eventSource;
let aiMessage = '';
eventSource.addEventListener('message', (event) => {
try {
const data = JSON.parse(event.data);
if (data.event === 'message') {
aiMessage += data.answer || '';
if (onMessage) onMessage(data.answer || '');
}
if (data.event === 'message_end') {
if (onComplete) onComplete({
conversation_id: data.conversation_id,
message: aiMessage
});
}
if (data.conversation_id) {
conversationId = data.conversation_id;
}
} catch (error) {
console.error('解析消息失败:', error);
}
});
eventSource.addEventListener('done', (event) => {
try {
const data = JSON.parse(event.data);
if (onComplete) onComplete(data);
} catch (error) {
console.error('解析完成事件失败:', error);
}
});
eventSource.addEventListener('close', (event) => {
try {
const data = JSON.parse(event.data);
console.log('连接正常结束:', data);
} catch (error) {
console.error('解析关闭事件失败:', error);
}
window.currentEventSource = null;
});
eventSource.addEventListener('error', (error) => {
console.error('EventSource错误:', error);
if (onError) onError({ error: 'EventSource连接错误' });
window.currentEventSource = null;
});
return eventSource;
} catch (error) {
console.error('创建EventSource失败:', error);
if (onError) onError({ error: error.message });
return null;
}
},
// 保存会话ID确保连续对话
if (conversationId) {
this.setConversationId(conversationId);
}
/**
* Fetch API 流式聊天
*/
async chatWithFetchStream(message, conversationId = '', onMessage, onComplete, onError) {
try {
let requestData;
let headers = {
'Accept': 'text/event-stream'
};
requestData = {
uniacid: store.state.uniacid || '1',
user_id: store.state.memberInfo?.id || '123456',
query: message,
conversation_id: conversationId || '',
stream: true,
inputs: {},
response_mode: 'streaming',
user: store.state.memberInfo?.id || '123456'
};
headers['Content-Type'] = 'application/json';
const response = await fetch('/api/kefu/chat', {
method: 'POST',
headers: headers,
body: JSON.stringify(requestData)
});
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
if (!response.body) {
throw new Error('响应体不可用');
}
const reader = response.body.getReader();
const decoder = new TextDecoder('utf-8');
let buffer = '';
let aiMessage = '';
while (true) {
const { done, value } = await reader.read();
if (done) break;
buffer += decoder.decode(value, { stream: true });
let lineEnd;
while ((lineEnd = buffer.indexOf('\n')) !== -1) {
const line = buffer.substring(0, lineEnd);
buffer = buffer.substring(lineEnd + 1);
if (line.startsWith('data: ')) {
try {
const data = JSON.parse(line.substring(6));
if (data.event === 'message' || data.event === 'text_message') {
const textContent = data.answer || data.text || '';
aiMessage += textContent;
if (onMessage) onMessage(textContent);
} else if (data.event === 'message_end' || data.event === 'done') {
if (onComplete) onComplete({
conversation_id: data.conversation_id,
message: aiMessage,
...data
});
} else if (data.event === 'error' && onError) {
onError(data);
}
if (data.conversation_id) {
conversationId = data.conversation_id;
}
} catch (e) {
console.warn('解析流式数据失败:', e);
// 模拟打字效果
let index = 0;
const chunkSize = 2; // 每次显示2个字符
return new Promise((resolve) => {
const timer = setInterval(() => {
if (index < content.length) {
const chunk = content.substring(index, index + chunkSize);
index += chunkSize;
if (onChunk) onChunk(chunk);
} else {
clearInterval(timer);
if (onComplete) {
onComplete({
content: content,
conversation_id: conversationId
});
}
resolve({ content, conversation_id: conversationId });
}
}
}
if (buffer.startsWith('data: ')) {
try {
const data = JSON.parse(buffer.substring(6));
if ((data.event === 'message' || data.event === 'text_message') && onMessage) {
const textContent = data.answer || data.text || '';
onMessage(textContent);
} else if ((data.event === 'message_end' || data.event === 'done') && onComplete) {
onComplete({
conversation_id: data.conversation_id,
message: aiMessage,
...data
});
}
} catch (e) {
console.warn('解析剩余数据失败:', e);
}
}
}, 80); // 打字速度80ms/次
});
} catch (error) {
console.error('Fetch流式聊天请求失败:', error);
if (onError) onError({ error: error.message });
}
},
/**
* HTTP流式请求修复conversationId未定义
*/
async sendHttpStream(message, onChunk, onComplete) {
const params = {
url: '/api/kefu/chat',
data: {
query: message,
conversation_id: '',
user_id: store.state.memberInfo?.id || 'anonymous',
stream: true,
uniacid: store.state.uniacid,
inputs: {},
response_mode: 'streaming',
user: store.state.memberInfo?.id || 'anonymous'
},
header: {
'Content-Type': 'application/json'
console.error('小程序流式消息降级失败:', error);
if (onComplete) {
onComplete({ error: error.message || '发送失败' });
}
throw error;
}
// #endif
// #ifdef H5
// H5使用真实流式EventSource / Fetch
return this.sendHttpStream(message, onChunk, onComplete);
// #endif
},
/**
* HTTP 流式请求(仅 H5 使用)
*/
async sendHttpStream(message, onChunk, onComplete) {
// #ifdef H5
try {
const url = Config.baseUrl + `/api/kefu/chat`;
@@ -263,105 +127,133 @@ export default {
inputs: {},
query: message,
response_mode: 'streaming',
user_id: store.state.memberInfo?.id || 'anonymous'
user_id: store.state.memberInfo?.id || 'anonymous',
conversation_id: this.getConversationId() || ''
})
})
const reader = response.body.getReader()
const decoder = new TextDecoder()
let content = ''
let buffer = ''
// 修复声明conversationId变量
let conversationId = '';
function processStreamData(buffer, callback) {
const lines = buffer.split('\n');
buffer = lines.pop() || '';
lines.forEach(line => {
line = line.trim();
if (!line) return;
if (line.startsWith('data:')) {
const dataPart = line.slice(5).trim();
if (dataPart) {
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
if (!response.body) {
throw new Error('响应体不可用');
}
const reader = response.body.getReader();
const decoder = new TextDecoder('utf-8');
let buffer = '';
let content = '';
let conversationId = '';
function processBuffer(buf, callback) {
const lines = buf.split('\n');
buf = lines.pop() || '';
for (const line of lines) {
const trimmed = line.trim();
if (trimmed.startsWith('data:')) {
const jsonStr = trimmed.slice(5).trim();
if (jsonStr) {
try {
const data = JSON.parse(dataPart);
const data = JSON.parse(jsonStr);
if (data.event === 'message') {
callback(data.answer || '');
const text = data.answer || data.text || '';
content += text;
callback(text);
}
if (data.conversation_id) {
conversationId = data.conversation_id;
}
if (data.event === 'message_end') {
console.log('对话完成');
// 可选:提前完成
}
} catch (error) {
console.error('解析流数据失败:', error);
} catch (e) {
console.warn('解析流数据失败:', e);
}
}
}
});
return buffer;
}
return buf;
}
while (true) {
const { done, value } = await reader.read()
if (done) break
const { done, value } = await reader.read();
if (done) break;
buffer += decoder.decode(value, { stream: true });
buffer = processStreamData(buffer, (newData) => {
if (newData) {
content += newData;
if (onChunk) onChunk(newData);
}
buffer = processBuffer(buffer, (chunk) => {
if (onChunk) onChunk(chunk);
});
}
if (onComplete) onComplete({ content, conversation_id: conversationId });
return { content, conversation_id: conversationId };
if (onComplete) {
onComplete({
content,
conversation_id: conversationId
});
}
return { content, conversation_id: conversationId };
} catch (error) {
console.error('HTTP流式请求失败:', error)
throw error
console.error('H5 流式请求失败:', error);
throw error;
}
// #endif
// #ifndef H5
const response = await http.sendRequest({
...params,
async: false
})
if (response.success && response.data) {
const content = response.data
const chunkSize = 3
let index = 0
const streamInterval = setInterval(() => {
if (index < content.length) {
const chunk = content.substring(index, index + chunkSize)
index += chunkSize
if (onChunk) onChunk(chunk)
} else {
clearInterval(streamInterval)
if (onComplete) onComplete(content)
}
}, 100)
}
// #ifdef MP-WEIXIN
// 理论上不会执行到这里,但防止 fallback
return this.sendStreamMessage(message, onChunk, onComplete);
// #endif
},
/**
* 处理API响应
* 处理API响应(统一格式)
*/
handleResponse(response, options) {
handleResponse(response) {
if (response.code === 0 || response.success) {
return {
success: true,
content: response.data?.answer || response.data?.content || response.data?.reply|| response.data,
content: response.data?.answer || response.data?.content || response.data?.reply || response.data,
conversationId: response.data?.conversation_id,
messageId: response.data?.message_id
}
};
} else {
throw new Error(response.message || 'AI服务返回错误')
throw new Error(response.message || 'AI服务返回错误');
}
},
/**
* 生成会话ID
* 获取当前会话ID
*/
getConversationId() {
return currentConversationId;
},
/**
* 设置并持久化会话ID
*/
setConversationId(id) {
if (id && id !== currentConversationId) {
currentConversationId = id;
try {
uni.setStorageSync(CONVERSATION_KEY, id);
} catch (e) {
console.error('保存会话ID失败:', e);
}
}
},
/**
* 清除会话ID
*/
clearConversationId() {
currentConversationId = null;
try {
uni.removeStorageSync(CONVERSATION_KEY);
} catch (e) {
console.error('清除会话ID失败:', e);
}
},
/**
* 生成新会话(如需)
*/
async generateConversationId() {
const params = {
@@ -374,16 +266,16 @@ export default {
header: {
'Content-Type': 'application/json'
}
}
};
const response = await http.sendRequest({
...params,
async: false
})
return this.handleResponse(response)
});
return this.handleResponse(response);
},
/**
* 获取AI服务状态
* 获取服务状态
*/
async getServiceStatus() {
try {
@@ -391,22 +283,23 @@ export default {
url: '/api/kefu/health',
async: false,
data: {}
})
const available = [response?.data?.status, response?.data?.components?.ai_service_config?.status].filter(item => item === 'healthy').length > 0;
});
const available = [response?.data?.status, response?.data?.components?.ai_service_config?.status]
.filter(item => item === 'healthy').length > 0;
return {
available,
reason: available ? '服务正常' : '服务异常'
}
};
} catch (error) {
return {
available: false,
reason: '服务检查失败'
}
};
}
},
/**
* 清除会话历史
* 清除会话历史(调用后端接口)
*/
async clearConversation(conversationId) {
try {
@@ -414,36 +307,13 @@ export default {
url: '/api/kefu/clear-conversation',
data: { conversation_id: conversationId },
async: false
})
return response.success
});
return response.success;
} catch (error) {
console.error('清除会话失败:', error)
return false
console.error('清除会话失败:', error);
return false;
}
},
getConversationId() {
return currentConversationId;
},
setConversationId(id) {
if (id && id !== currentConversationId) {
currentConversationId = id;
try {
uni.setStorageSync(CONVERSATION_KEY, id);
} catch (e) {
console.error('保存会话ID失败:', e);
}
}
},
clearConversationId() {
currentConversationId = null;
try {
uni.removeStorageSync(CONVERSATION_KEY);
} catch (e) {
console.error('清除会话ID失败:', e);
}
},
/**
* 获取会话历史
@@ -485,5 +355,80 @@ export default {
console.error('获取会话历史失败:', error);
throw new Error(error.message || '获取会话历史时发生错误,请稍后重试');
}
},
// ================================
// 以下方法仅用于 H5小程序无效
// ================================
/**
* [H5 Only] EventSource 流式聊天(备用)
*/
chatWithEventSource(message, conversationId = '', onMessage, onComplete, onError) {
// #ifdef H5
if (window.currentEventSource) {
window.currentEventSource.close();
}
const params = new URLSearchParams({
uniacid: store.state.uniacid || '1',
user_id: store.state.memberInfo?.id || '123456',
query: message,
conversation_id: conversationId || '',
stream: 'true'
});
const url = `${Config.baseUrl}/api/kefu/chat?${params.toString()}`;
try {
const eventSource = new EventSource(url);
window.currentEventSource = eventSource;
let aiMessage = '';
eventSource.onmessage = (event) => {
try {
const data = JSON.parse(event.data);
if (data.event === 'message') {
aiMessage += data.answer || '';
if (onMessage) onMessage(data.answer || '');
}
if (data.event === 'message_end') {
if (onComplete) onComplete({
conversation_id: data.conversation_id,
message: aiMessage
});
}
} catch (error) {
console.error('解析消息失败:', error);
}
};
eventSource.onerror = (error) => {
console.error('EventSource错误:', error);
if (onError) onError({ error: '连接失败' });
window.currentEventSource = null;
};
return eventSource;
} catch (error) {
console.error('创建EventSource失败:', error);
if (onError) onError({ error: error.message });
return null;
}
// #endif
// #ifdef MP-WEIXIN
console.warn('chatWithEventSource 不支持微信小程序');
return null;
// #endif
},
/**
* [H5 Only] Fetch 流式聊天(备用)
*/
async chatWithFetchStream(message, conversationId = '', onMessage, onComplete, onError) {
// #ifdef H5
// 实际逻辑已在 sendHttpStream 中实现,此处可复用或留空
return this.sendHttpStream(message, onMessage, (res) => {
onComplete?.({ message: res.content, conversation_id: res.conversation_id });
});
// #endif
// #ifdef MP-WEIXIN
console.warn('chatWithFetchStream 不支持微信小程序');
return null;
// #endif
}
}
};

View File

@@ -0,0 +1,511 @@
/**
* 客服统一处理服务
* 整合各种客服方式,提供统一的调用接口
*/
export class CustomerService {
constructor(vueInstance, externalConfig = null) {
this.vm = vueInstance;
this.externalConfig = externalConfig; // 外部传入的最新配置(优先级最高)
this.latestPlatformConfig = null;
}
/**
* 强制刷新配置(支持传入外部配置)
* @param {Object} externalConfig 外部最新配置
*/
refreshConfig(externalConfig = null) {
this.externalConfig = externalConfig || this.externalConfig;
this.latestPlatformConfig = null;
return this.getPlatformConfig();
}
/**
* 获取平台配置
* @returns {Object} 平台对应的客服配置
*/
getPlatformConfig() {
if (this.latestPlatformConfig) {
return this.latestPlatformConfig;
}
// 优先级:外部传入的最新配置 > vuex配置 > 空对象
const servicerConfig = this.externalConfig || this.vm.$store.state.servicerConfig || {};
console.log(`【实时客服配置】`, servicerConfig);
let platformConfig = null;
// #ifdef H5
platformConfig = servicerConfig.h5 ? (typeof servicerConfig.h5 === 'object' ? servicerConfig.h5 : null) : null;
// #endif
// #ifdef MP-WEIXIN
platformConfig = servicerConfig.weapp ? (typeof servicerConfig.weapp === 'object' ? servicerConfig.weapp : null) : null;
// #endif
// #ifdef MP-ALIPAY
platformConfig = servicerConfig.aliapp ? (typeof servicerConfig.aliapp === 'object' ? servicerConfig.aliapp : null) : null;
// #endif
// #ifdef PC
platformConfig = servicerConfig.pc ? (typeof servicerConfig.pc === 'object' ? servicerConfig.pc : null) : null;
// #endif
// 处理空数组情况你的配置中pc/aliapp是空数组转为null
if (Array.isArray(platformConfig)) {
platformConfig = null;
}
this.latestPlatformConfig = platformConfig;
return platformConfig;
}
/**
* 获取企业微信配置
* @returns {Object} 企业微信配置
*/
getWxworkConfig() {
return this.vm.$store.state.wxworkConfig || {};
}
/**
* 检查客服配置是否可用
* @returns {boolean} 是否有可用配置
*/
isConfigAvailable() {
const config = this.getPlatformConfig();
return config && typeof config === 'object' && config.type;
}
/**
* 验证客服配置完整性
* @returns {Object} 验证结果
*/
validateConfig() {
const config = this.getPlatformConfig();
const wxworkConfig = this.getWxworkConfig();
const result = {
isValid: true,
errors: [],
warnings: []
};
if (!config) {
result.isValid = false;
result.errors.push('客服配置不存在');
return result;
}
if (config.type === 'aikefu') {
return result;
}
if (!config.type) {
result.isValid = false;
result.errors.push('客服类型未配置');
}
if (config.type === 'wxwork') {
if (!wxworkConfig) {
result.isValid = false;
result.errors.push('企业微信配置不存在');
} else {
if (!wxworkConfig.enable) {
result.warnings.push('企业微信功能未启用');
}
if (!wxworkConfig.contact_url) {
result.warnings.push('企业微信活码链接未配置,将使用原有客服方式');
}
}
}
return result;
}
/**
* 跳转到Dify客服页面
*/
openDifyService() {
try {
if (this.vm.setAiUnreadCount) {
this.vm.setAiUnreadCount(0);
}
// 强制跳转,忽略框架层的封装
uni.redirectTo({
url: '/pages_tool/ai-chat/index',
fail: (err) => {
// 兜底使用window.location跳转H5
// #ifdef H5
window.location.href = '/pages_tool/ai-chat/index';
// #endif
console.error('跳转Dify客服失败:', err);
uni.showToast({
title: '跳转客服失败',
icon: 'none'
});
}
});
} catch (e) {
console.error('跳转Dify客服异常:', e);
uni.showToast({
title: '跳转客服失败',
icon: 'none'
});
}
}
/**
* 处理客服点击事件
* @param {Object} options 选项参数
*/
handleCustomerClick(options = {}) {
const validation = this.validateConfig();
if (!validation.isValid) {
console.error('客服配置验证失败:', validation.errors);
this.showConfigErrorPopup(validation.errors);
return;
}
if (validation.warnings.length > 0) {
console.warn('客服配置警告:', validation.warnings);
}
const config = this.getPlatformConfig();
const { niushop = {}, sendMessageTitle = '', sendMessagePath = '', sendMessageImg = '' } = options;
if (config.type === 'none') {
this.showNoServicePopup();
return;
}
// 核心分支根据最新的type处理
switch (config.type) {
case 'aikefu':
this.openDifyService();
break;
case 'wxwork':
this.openWxworkService(false, config, options);
break;
case 'third':
this.openThirdService(config);
break;
case 'niushop':
this.openNiushopService(niushop);
break;
case 'weapp':
this.openWeappService(config, options);
break;
case 'aliapp':
this.openAliappService(config);
break;
default:
this.makePhoneCall();
}
}
/**
* 打开企业微信客服
* @param {boolean} useOriginalService 是否使用原有客服方式
* @param {Object} servicerConfig 客服配置
* @param {Object} options 选项参数
*/
openWxworkService(useOriginalService = false, servicerConfig = null, options = {}) {
const config = servicerConfig || this.getPlatformConfig();
const wxworkConfig = this.getWxworkConfig();
const { sendMessageTitle = '', sendMessagePath = '', sendMessageImg = '' } = options;
// #ifdef MP-WEIXIN
if (wxworkConfig?.enable && wxworkConfig?.contact_url && !useOriginalService) {
wx.navigateToMiniProgram({
appId: 'wxeb490c6f9b154ef9',
path: `pages/contacts/externalContactDetail?url=${encodeURIComponent(wxworkConfig.contact_url)}`,
success: () => console.log('跳转企业微信成功'),
fail: (err) => {
console.error('跳转企业微信失败:', err);
this.fallbackToOriginalService();
}
});
} else {
wx.openCustomerServiceChat({
extInfo: { url: config.wxwork_url },
corpId: config.corpid,
showMessageCard: true,
sendMessageTitle,
sendMessagePath,
sendMessageImg
});
}
// #endif
// #ifdef H5
if (wxworkConfig?.enable && wxworkConfig?.contact_url) {
window.location.href = wxworkConfig.contact_url;
} else if (config.wxwork_url) {
location.href = config.wxwork_url;
} else {
this.fallbackToPhoneCall();
}
// #endif
}
/**
* 打开第三方客服
* @param {Object} config 客服配置
*/
openThirdService(config) {
if (config.third_url) {
window.location.href = config.third_url;
} else {
this.fallbackToPhoneCall();
}
}
/**
* 打开牛商客服
* @param {Object} niushop 牛商参数
*/
openNiushopService(niushop) {
if (Object.keys(niushop).length > 0) {
this.vm.$util.redirectTo('/pages_tool/chat/room', niushop);
} else {
this.makePhoneCall();
}
}
/**
* 打开微信小程序客服
* @param {Object} config 客服配置
* @param {Object} options 选项参数
*/
openWeappService(config, options = {}) {
if (!this.shouldUseCustomService(config)) {
console.log('使用官方微信小程序客服');
return;
}
console.log('使用自定义微信小程序客服');
this.handleCustomWeappService(config, options);
}
/**
* 处理自定义微信小程序客服
* @param {Object} config 客服配置
* @param {Object} options 选项参数
*/
handleCustomWeappService(config, options = {}) {
const { sendMessageTitle = '', sendMessagePath = '', sendMessageImg = '' } = options;
if (config.customServiceUrl) {
let url = config.customServiceUrl;
const params = [];
if (sendMessageTitle) params.push(`title=${encodeURIComponent(sendMessageTitle)}`);
if (sendMessagePath) params.push(`path=${encodeURIComponent(sendMessagePath)}`);
if (sendMessageImg) params.push(`img=${encodeURIComponent(sendMessageImg)}`);
if (params.length > 0) {
url += (url.includes('?') ? '&' : '?') + params.join('&');
}
uni.navigateTo({
url: url,
fail: (err) => {
console.error('跳转自定义客服页面失败:', err);
this.tryThirdPartyService(config, options);
}
});
return;
}
this.tryThirdPartyService(config, options);
}
/**
* 尝试使用第三方客服
* @param {Object} config 客服配置
* @param {Object} options 选项参数
*/
tryThirdPartyService(config, options = {}) {
if (config.thirdPartyServiceUrl) {
// #ifdef H5
window.open(config.thirdPartyServiceUrl, '_blank');
// #endif
// #ifdef MP-WEIXIN
if (config.thirdPartyMiniAppId) {
wx.navigateToMiniProgram({
appId: config.thirdPartyMiniAppId,
path: config.thirdPartyMiniAppPath || '',
fail: (err) => {
console.error('跳转第三方小程序失败:', err);
this.fallbackToPhoneCall();
}
});
} else {
uni.setClipboardData({
data: config.thirdPartyServiceUrl,
success: () => {
uni.showModal({
title: '客服链接已复制',
content: '客服链接已复制到剪贴板,请在浏览器中粘贴访问',
showCancel: false
});
}
});
}
// #endif
return;
}
this.fallbackToPhoneCall();
}
/**
* 降级到电话客服
*/
fallbackToPhoneCall() {
uni.showModal({
title: '联系客服',
content: '在线客服暂时不可用,是否拨打电话联系客服?',
success: (res) => {
if (res.confirm) {
this.makePhoneCall();
}
}
});
}
/**
* 打开支付宝小程序客服
* @param {Object} config 客服配置
*/
openAliappService(config) {
console.log('支付宝小程序客服', config);
switch (config.type) {
case 'aikefu':
this.openDifyService();
break;
case 'third':
this.openThirdService(config);
break;
default:
console.log('使用支付宝官方客服');
break;
}
}
/**
* 拨打电话
*/
makePhoneCall() {
this.vm.$api.sendRequest({
url: '/api/site/shopcontact',
success: res => {
if (res.code === 0 && res.data?.mobile) {
uni.makePhoneCall({
phoneNumber: res.data.mobile
});
} else {
uni.showToast({
title: '暂无客服电话',
icon: 'none'
});
}
},
fail: () => {
uni.showToast({
title: '获取客服电话失败',
icon: 'none'
});
}
});
}
/**
* 显示无客服弹窗
*/
showNoServicePopup() {
const siteInfo = this.vm.$store.state.siteInfo || {};
const message = siteInfo?.site_tel
? `请联系客服,客服电话是${siteInfo.site_tel}`
: '抱歉,商家暂无客服,请线下联系';
uni.showModal({
title: '联系客服',
content: message,
showCancel: false
});
}
/**
* 显示配置错误弹窗
* @param {Array} errors 错误列表
*/
showConfigErrorPopup(errors) {
const message = errors.join('\n');
uni.showModal({
title: '配置错误',
content: `客服配置有误:\n${message}`,
showCancel: false
});
}
/**
* 降级处理:使用原有客服方式
*/
fallbackToOriginalService() {
uni.showModal({
title: '提示',
content: '无法直接添加企业微信客服,是否使用其他方式联系客服?',
success: (res) => {
if (res.confirm) {
this.openWxworkService(true);
}
}
});
}
/**
* 获取客服按钮配置
* @returns {Object} 按钮配置
*/
getButtonConfig() {
const config = this.getPlatformConfig();
if (!config) return { openType: '' };
let openType = '';
// #ifdef MP-WEIXIN
if (config.type === 'weapp') {
openType = config.useOfficial !== false ? 'contact' : '';
}
// #endif
// #ifdef MP-ALIPAY
if (config.type === 'aliapp') openType = 'contact';
// #endif
return { ...config, openType };
}
/**
* 判断是否应该使用自定义客服处理
* @param {Object} config 客服配置
* @returns {boolean} 是否使用自定义客服
*/
shouldUseCustomService(config) {
// #ifdef MP-WEIXIN
if (config?.type === 'weapp') {
return config.useOfficial === false;
}
// #endif
return true;
}
}
/**
* 创建客服服务实例
* @param {Object} vueInstance Vue实例
* @param {Object} externalConfig 外部最新配置
* @returns {CustomerService} 客服服务实例
*/
export function createCustomerService(vueInstance, externalConfig = null) {
return new CustomerService(vueInstance, externalConfig);
}

View File

@@ -1,186 +1,190 @@
export default {
data() {
return {
// 页面样式,动态设置主色调
themeColor: '' //''--base-color:#fa5d14;--base-help-color:#ff7e00;'
}
},
onLoad() {},
onShow() {
// 刷新多语言
this.$langConfig.refresh();
let time = setInterval(() => {
let theme = this.themeStyle;
if (theme && theme.main_color) {
this.themeColorSet();
clearInterval(time);
}
}, 50);
},
computed: {
themeStyle() {
return this.$store.state.themeStyle;
},
// 插件是否存在
addonIsExist() {
return this.$store.state.addonIsExist;
},
tabBarList() {
return this.$store.state.tabBarList;
},
siteInfo() {
return this.$store.state.siteInfo;
},
memberInfo() {
return this.$store.state.memberInfo;
},
storeToken() {
return this.$store.state.token;
},
bottomNavHidden() {
return this.$store.state.bottomNavHidden;
},
globalStoreConfig() {
return this.$store.state.globalStoreConfig;
},
globalStoreInfo() {
return this.$store.state.globalStoreInfo;
},
// 定位信息
location() {
return this.$store.state.location;
},
// 定位信息(缓存)
locationStorage() {
let data = uni.getStorageSync('location');
if (data) {
var date = new Date();
if (this.mapConfig.wap_valid_time > 0) {
data.is_expired = (date.getTime() / 1000) > data.valid_time; // 是否过期
} else {
data.is_expired = false;
}
}
return data;
},
// 默认总店(定位失败后使用)
defaultStoreInfo() {
return this.$store.state.defaultStoreInfo;
},
// 组件刷新计数
componentRefresh() {
return this.$store.state.componentRefresh;
},
// 客服配置
servicerConfig() {
return this.$store.state.servicerConfig;
},
diySeckillInterval() {
return this.$store.state.diySeckillInterval;
},
tabBarHeight() {
return this.$store.state.tabBarHeight;
},
mapConfig() {
return this.$store.state.mapConfig;
},
copyright() {
let copyright = this.$store.state.copyright;
// 判断是否授权
if (copyright && !copyright.auth) {
copyright.logo = '';
copyright.copyright_link = '';
}
return copyright;
},
cartList() {
return this.$store.state.cartList;
},
cartIds() {
return this.$store.state.cartIds;
},
cartNumber() {
return this.$store.state.cartNumber;
},
cartMoney() {
return this.$store.state.cartMoney;
}
},
methods: {
themeColorSet() {
let theme = this.themeStyle;
this.themeColor = `--base-color:${theme.main_color};--base-help-color:${theme.aux_color};`;
if (this.tabBarHeight != '56px') this.themeColor += `--tab-bar-height:${this.tabBarHeight};`
Object.keys(theme).forEach(key => {
let data = theme[key];
if (typeof(data) == "object") {
Object.keys(data).forEach(k => {
this.themeColor += '--' + k.replace(/_/g, "-") + ':' + data[k] + ';';
});
} else if (typeof(key) == "string" && key) {
this.themeColor += '--' + key.replace(/_/g, "-") + ':' + data + ';';
}
});
for (let i = 9; i >= 5; i--) {
let color = this.$util.colourBlend(theme.main_color, '#ffffff', (i / 10));
this.themeColor += `--base-color-light-${i}:${color};`;
}
},
// 颜色变浅(>0、变深函数<0
lightenDarkenColor(color, amount) {
var usePound = false;
if (color[0] == "#") {
color = color.slice(1);
usePound = true;
}
var num = parseInt(color, 16);
var r = (num >> 16) + amount;
if (r > 255) r = 255;
else if (r < 0) r = 0;
var b = ((num >> 8) & 0x00FF) + amount;
if (b > 255) b = 255;
else if (b < 0) b = 0;
var g = (num & 0x0000FF) + amount;
if (g > 255) g = 255;
else if (g < 0) g = 0;
return (usePound ? "#" : "") + (g | (b << 8) | (r << 16)).toString(16);
},
/**
* 切换门店
* @param {Object} info 门店信息
* @param {Object} isJump 是否跳转到首页
*/
changeStore(info, isJump) {
if (info) {
this.$store.commit('setGlobalStoreInfo', info);
}
let route = this.$util.getCurrRoute();
if (isJump && route != 'pages/index/index') {
uni.setStorageSync('manual_change_store', true); // 手动切换门店
this.$store.dispatch('getCartNumber'); //重新获取购物车数据
this.$util.redirectTo('/pages/index/index');
}
}
},
filters: {
/**
* 金额格式化输出
* @param {Object} money
*/
moneyFormat(money) {
if (isNaN(parseFloat(money))) return money;
return parseFloat(money).toFixed(2);
}
}
export default {
data() {
return {
// 页面样式,动态设置主色调
themeColor: '' //''--base-color:#fa5d14;--base-help-color:#ff7e00;'
}
},
onLoad() {},
onShow() {
// 刷新多语言
this.$langConfig.refresh();
let time = setInterval(() => {
let theme = this.themeStyle;
if (theme && theme.main_color) {
this.themeColorSet();
clearInterval(time);
}
}, 50);
},
computed: {
themeStyle() {
return this.$store.state.themeStyle;
},
// 插件是否存在
addonIsExist() {
return this.$store.state.addonIsExist;
},
tabBarList() {
return this.$store.state.tabBarList;
},
siteInfo() {
return this.$store.state.siteInfo;
},
memberInfo() {
return this.$store.state.memberInfo;
},
storeToken() {
return this.$store.state.token;
},
bottomNavHidden() {
return this.$store.state.bottomNavHidden;
},
globalStoreConfig() {
return this.$store.state.globalStoreConfig;
},
globalStoreInfo() {
return this.$store.state.globalStoreInfo;
},
// 定位信息
location() {
return this.$store.state.location;
},
// 定位信息(缓存)
locationStorage() {
let data = uni.getStorageSync('location');
if (data) {
var date = new Date();
if (this.mapConfig.wap_valid_time > 0) {
data.is_expired = (date.getTime() / 1000) > data.valid_time; // 是否过期
} else {
data.is_expired = false;
}
}
return data;
},
// 默认总店(定位失败后使用)
defaultStoreInfo() {
return this.$store.state.defaultStoreInfo;
},
// 组件刷新计数
componentRefresh() {
return this.$store.state.componentRefresh;
},
// 客服配置
servicerConfig() {
return this.$store.state.servicerConfig;
},
// 企业微信配置
wxworkConfig() {
return this.$store.state.wxworkConfig;
},
diySeckillInterval() {
return this.$store.state.diySeckillInterval;
},
tabBarHeight() {
return this.$store.state.tabBarHeight;
},
mapConfig() {
return this.$store.state.mapConfig;
},
copyright() {
let copyright = this.$store.state.copyright;
// 判断是否授权
if (copyright && !copyright.auth) {
copyright.logo = '';
copyright.copyright_link = '';
}
return copyright;
},
cartList() {
return this.$store.state.cartList;
},
cartIds() {
return this.$store.state.cartIds;
},
cartNumber() {
return this.$store.state.cartNumber;
},
cartMoney() {
return this.$store.state.cartMoney;
}
},
methods: {
themeColorSet() {
let theme = this.themeStyle;
this.themeColor = `--base-color:${theme.main_color};--base-help-color:${theme.aux_color};`;
if (this.tabBarHeight != '56px') this.themeColor += `--tab-bar-height:${this.tabBarHeight};`
Object.keys(theme).forEach(key => {
let data = theme[key];
if (typeof(data) == "object") {
Object.keys(data).forEach(k => {
this.themeColor += '--' + k.replace(/_/g, "-") + ':' + data[k] + ';';
});
} else if (typeof(key) == "string" && key) {
this.themeColor += '--' + key.replace(/_/g, "-") + ':' + data + ';';
}
});
for (let i = 9; i >= 5; i--) {
let color = this.$util.colourBlend(theme.main_color, '#ffffff', (i / 10));
this.themeColor += `--base-color-light-${i}:${color};`;
}
},
// 颜色变浅(>0、变深函数<0
lightenDarkenColor(color, amount) {
var usePound = false;
if (color[0] == "#") {
color = color.slice(1);
usePound = true;
}
var num = parseInt(color, 16);
var r = (num >> 16) + amount;
if (r > 255) r = 255;
else if (r < 0) r = 0;
var b = ((num >> 8) & 0x00FF) + amount;
if (b > 255) b = 255;
else if (b < 0) b = 0;
var g = (num & 0x0000FF) + amount;
if (g > 255) g = 255;
else if (g < 0) g = 0;
return (usePound ? "#" : "") + (g | (b << 8) | (r << 16)).toString(16);
},
/**
* 切换门店
* @param {Object} info 门店信息
* @param {Object} isJump 是否跳转到首页
*/
changeStore(info, isJump) {
if (info) {
this.$store.commit('setGlobalStoreInfo', info);
}
let route = this.$util.getCurrRoute();
if (isJump && route != 'pages/index/index') {
uni.setStorageSync('manual_change_store', true); // 手动切换门店
this.$store.dispatch('getCartNumber'); //重新获取购物车数据
this.$util.redirectTo('/pages/index/index');
}
}
},
filters: {
/**
* 金额格式化输出
* @param {Object} money
*/
moneyFormat(money) {
if (isNaN(parseFloat(money))) return money;
return parseFloat(money).toFixed(2);
}
}
}

File diff suppressed because it is too large Load Diff

187
common/js/wxwork-jssdk.js Normal file
View File

@@ -0,0 +1,187 @@
/**
* 企业微信JS-SDK调用
*/
let WxWork = function () {
// 企业微信JS-SDK
this.wxwork = null;
/**
* 初始化企业微信JS-SDK
* @param {Object} params - 初始化参数
* @param {string} params.corpId - 企业ID
* @param {string} params.agentId - 应用ID
* @param {string} params.timestamp - 时间戳
* @param {string} params.nonceStr - 随机字符串
* @param {string} params.signature - 签名
* @param {Array} params.jsApiList - 需要使用的JS接口列表
*/
this.init = function (params) {
if (typeof wx !== 'undefined' && wx.config) {
// 小程序环境下的企业微信
this.wxwork = wx;
} else if (typeof WWOpenData !== 'undefined') {
// H5环境下的企业微信
this.wxwork = WWOpenData;
} else {
console.error('企业微信JS-SDK未加载');
return false;
}
this.wxwork.config({
beta: true, // 必须这么写否则wx.invoke调用形式的jsapi会有问题
debug: false, // 开启调试模式
corpId: params.corpId, // 必填,企业号的唯一标识
agentId: params.agentId, // 必填企业微信应用ID
timestamp: params.timestamp, // 必填,生成签名的时间戳
nonceStr: params.nonceStr, // 必填,生成签名的随机串
signature: params.signature, // 必填,签名
jsApiList: params.jsApiList || [
'openUserProfile',
'openEnterpriseChat',
'getContext',
'getCurExternalContact',
'openExistedChatWithMsg'
] // 必填需要使用的JS接口列表
});
return true;
};
/**
* 添加企业微信联系人
* @param {Object} params - 参数
* @param {string} params.userId - 用户ID
* @param {Function} success - 成功回调
* @param {Function} fail - 失败回调
*/
this.addContact = function (params, success, fail) {
if (!this.wxwork) {
console.error('企业微信JS-SDK未初始化');
if (fail) fail('企业微信JS-SDK未初始化');
return;
}
this.wxwork.ready(() => {
this.wxwork.invoke('openUserProfile', {
type: 'external', // 外部联系人
userId: params.userId // 用户ID
}, (res) => {
if (res.err_msg === 'openUserProfile:ok') {
if (success) success(res);
} else {
console.error('打开用户资料失败:', res);
if (fail) fail(res.err_msg);
}
});
});
};
/**
* 打开企业微信客服会话
* @param {Object} params - 参数
* @param {string} params.corpId - 企业ID
* @param {string} params.url - 客服URL
* @param {string} params.name - 会话名称
* @param {Function} success - 成功回调
* @param {Function} fail - 失败回调
*/
this.openCustomerService = function (params, success, fail) {
if (!this.wxwork) {
console.error('企业微信JS-SDK未初始化');
if (fail) fail('企业微信JS-SDK未初始化');
return;
}
this.wxwork.ready(() => {
// #ifdef MP-WEIXIN
if (typeof wx !== 'undefined' && wx.openCustomerServiceChat) {
// 微信小程序环境
wx.openCustomerServiceChat({
extInfo: {
url: params.url
},
corpId: params.corpId,
showMessageCard: true,
sendMessageTitle: params.sendMessageTitle || '',
sendMessagePath: params.sendMessagePath || '',
sendMessageImg: params.sendMessageImg || ''
});
if (success) success();
}
// #endif
// #ifdef H5
else if (typeof WWOpenData !== 'undefined') {
// H5环境
window.location.href = params.url;
if (success) success();
}
// #endif
else {
// 直接跳转链接
window.location.href = params.url;
if (success) success();
}
});
};
/**
* 生成企业微信活码链接
* @param {Object} params - 参数
* @param {string} params.configId - 活码配置ID
* @param {string} params.userId - 用户ID
* @returns {string} 活码链接
*/
this.generateContactUrl = function (params) {
// 企业微信活码链接格式
const baseUrl = 'https://work.weixin.qq.com/kfid';
if (params.configId) {
return `${baseUrl}/${params.configId}`;
}
return null;
};
/**
* 检查环境是否支持企业微信
* @returns {boolean} 是否支持
*/
this.isSupported = function () {
// #ifdef MP-WEIXIN
return typeof wx !== 'undefined' && wx.openCustomerServiceChat;
// #endif
// #ifdef H5
return typeof WWOpenData !== 'undefined' || /wxwork/i.test(navigator.userAgent);
// #endif
return false;
};
/**
* 获取当前环境信息
* @returns {Object} 环境信息
*/
this.getEnvironment = function () {
// #ifdef MP-WEIXIN
return {
platform: 'miniprogram',
isWxWork: false,
supportContact: typeof wx !== 'undefined' && wx.openCustomerServiceChat
};
// #endif
// #ifdef H5
const isWxWork = /wxwork/i.test(navigator.userAgent);
return {
platform: 'h5',
isWxWork: isWxWork,
supportContact: isWxWork || typeof WWOpenData !== 'undefined'
};
// #endif
return {
platform: 'unknown',
isWxWork: false,
supportContact: false
};
};
}
export {
WxWork
}

View File

@@ -35,7 +35,7 @@
</template>
<script>
//
//
export default {
name: 'diy-audio',
props: {

View File

@@ -223,6 +223,7 @@
</template>
<script>
// 组件组
export default {
components: {},
props: {

View File

@@ -181,6 +181,7 @@
</template>
<script>
// 秒杀
export default {
name: 'diy-seckill',
props: {

View File

@@ -1,209 +1,307 @@
<template>
<!-- 悬浮按钮 -->
<view v-if="pageCount == 1 || need" class="fixed-box" :style="{ height: fixBtnShow ? '330rpx' : '120rpx' }">
<!-- AI智能助手 -->
<view class="btn-item" v-if="fixBtnShow && enableAIChat" @click="openAIChat" :style="{backgroundImage:'url('+(aiAgentimg?aiAgentimg:'')+')',backgroundSize:'100% 100%'}">
<!-- 核心修改添加🤖表情保留原有判断逻辑 -->
<text class="ai-icon" v-if="!aiAgentimg">🤖</text>
<!-- 未读消息小红点 -->
<view v-if="unreadCount > 0" class="unread-badge">
<text class="badge-text">{{ unreadCount > 99 ? '99+' : unreadCount }}</text>
</view>
<view v-if="pageCount == 1 || need" class="fixed-box" :style="{ height: fixBtnShow ? (isH5 ? '180rpx' : '330rpx') : '120rpx' }">
<!-- #ifdef MP-WEIXIN -->
<!-- 微信小程序根据配置自动选择官方客服/自定义客服 -->
<button
class="btn-item"
v-if="fixBtnShow"
hoverClass="none"
:open-type="weappOfficialService ? 'contact' : ''"
@click="weappOfficialService ? '' : handleWeappCustomerService"
:style="{ backgroundImage: 'url(' + (kefuimg ? kefuimg : '') + ')', backgroundSize: '100% 100%' }"
>
<text class="icox icox-kefu" v-if="!kefuimg"></text>
</button>
<!-- #endif -->
<!-- #ifdef H5 -->
<!-- H5逻辑保持不变 -->
<button
class="btn-item"
v-if="fixBtnShow"
hoverClass="none"
@click="handleCustomerService"
:style="{ backgroundImage: 'url(' + (kefuimg ? kefuimg : '') + ')', backgroundSize: '100% 100%' }"
>
<text class="icox icox-kefu" v-if="!kefuimg"></text>
<view v-if="unreadCount > 0 && isDifyService" class="unread-badge">
<text class="badge-text">{{ unreadCount > 99 ? '99+' : unreadCount }}</text>
</view>
</button>
<!-- #endif -->
<!-- #ifdef MP-WEIXIN -->
<button class="btn-item" v-if="fixBtnShow" hoverClass="none" openType="contact" sessionFrom="weapp" showMessageCard="true" :style="{backgroundImage:'url('+(kefuimg?kefuimg:'')+')',backgroundSize:'100% 100%'}">
<text class="icox icox-kefu" v-if="!kefuimg"></text>
</button>
<!-- #endif -->
<!-- 电话 -->
<view class="btn-item" v-if="fixBtnShow" @click="call()" :style="{backgroundImage:'url('+(phoneimg?phoneimg:'')+')',backgroundSize:'100% 100%'}">
<text class="iconfont icon-dianhua" v-if="!phoneimg"></text>
<!-- #ifndef H5 -->
<view
class="btn-item"
v-if="fixBtnShow && isDifyService"
@click="handleCustomerService"
:style="{ backgroundImage: 'url(' + (aiAgentimg ? aiAgentimg : '') + ')', backgroundSize: '100% 100%' }"
>
<text class="ai-icon" v-if="!aiAgentimg">🤖</text>
<view v-if="unreadCount > 0" class="unread-badge">
<text class="badge-text">{{ unreadCount > 99 ? '99+' : unreadCount }}</text>
</view>
</view>
<!-- #endif -->
<view
class="btn-item"
v-if="fixBtnShow"
@click="call()"
:style="{ backgroundImage: 'url(' + (phoneimg ? phoneimg : '') + ')', backgroundSize: '100% 100%' }"
>
<text class="iconfont icon-dianhua" v-if="!phoneimg"></text>
</view>
</view>
</template>
<script>
import { mapGetters, mapMutations } from 'vuex'
export default {
name: 'hover-nav',
props: {
need: {
type: Boolean,
default: false
},
},
data() {
return {
pageCount: 0,
fixBtnShow: true,
tel:'',
kefuimg:'',
phoneimg:''
};
},
created() {
this.kefuimg = this.$util.getDefaultImage().kefu
this.phoneimg = this.$util.getDefaultImage().phone
this.pageCount = getCurrentPages().length;
var that = this
uni.getStorage({
key:'shopInfo',
success(e){
that.tel = e.data.mobile
}
})
},
computed: {
...mapGetters([
'globalAIKefuConfig',
'aiUnreadCount'
]),
aiAgentimg() {
return this.globalAIKefuConfig?.icon || this.$util.getDefaultImage().aiAgent || '' // AI智能助手的头像
},
unreadCount() {
return this.aiUnreadCount
},
enableAIChat() {
return this.globalAIKefuConfig?.enable || true // 是否开启AI智能助手
},
},
methods: {
...mapMutations([
'setAiUnreadCount'
]),
//拨打电话
call(){
uni.makePhoneCall({
phoneNumber:this.tel+''
})
},
// 打开AI聊天弹窗
openAIChat() {
if (this.enableAIChat) {
this.setAiUnreadCount(0);
}
this.$util.redirectTo('/pages_tool/ai-chat/index')
}
import { createCustomerService } from '@/common/js/customer-service.js';
import { mapGetters, mapMutations } from 'vuex';
export default {
name: 'hover-nav',
props: {
need: {
type: Boolean,
default: false
}
};
},
data() {
return {
pageCount: 0,
fixBtnShow: true,
tel: '',
kefuimg: '',
phoneimg: '',
customerService: null,
buttonConfig: null,
isH5: false,
platformConfig: null,
latestConfig: null,
weappOfficialService: false // 微信小程序是否使用官方客服
};
},
created() {
// 1. 判断平台类型
// #ifdef H5
this.isH5 = true;
// #endif
// #ifdef MP-WEIXIN
this.isH5 = false;
// #endif
// 2. 初始化资源
this.kefuimg = this.$util.getDefaultImage().kefu;
this.phoneimg = this.$util.getDefaultImage().phone;
this.pageCount = getCurrentPages().length;
// 3. 获取店铺电话
this.getShopTel();
// 4. 首次加载获取最新配置
this.getLatestConfig().then(config => {
this.latestConfig = config;
this.initCustomerService(config);
// 微信小程序:判断是否使用官方客服
this.initWeappServiceType();
});
},
computed: {
...mapGetters([
'globalAIKefuConfig',
'aiUnreadCount'
]),
isDifyService() {
const serviceType = this.platformConfig?.type || '';
return serviceType === 'aikefu';
},
aiAgentimg() {
return this.globalAIKefuConfig?.icon || this.$util.getDefaultImage().aiAgent || '';
},
unreadCount() {
return this.aiUnreadCount;
}
},
methods: {
...mapMutations([
'setAiUnreadCount'
]),
/**
* 获取最新配置H5禁用缓存小程序保留默认
*/
async getLatestConfig() {
return new Promise((resolve) => {
// H5强制请求最新配置小程序优先用vuex缓存
if (this.isH5) {
this.$api.sendRequest({
url: '/api/site/getServicerConfig',
header: {
'Cache-Control': 'no-cache, no-store, must-revalidate',
'Pragma': 'no-cache',
'Expires': '0'
},
data: { t: new Date().getTime() },
success: (res) => {
const config = res.code === 0 ? res.data : this.$store.state.servicerConfig || {};
this.$store.commit('UPDATE_SERVICER_CONFIG', config);
resolve(config);
},
fail: () => resolve(this.$store.state.servicerConfig || {})
});
} else {
// 小程序直接用vuex缓存后台修改后需重启开发者工具
resolve(this.$store.state.servicerConfig || {});
}
});
},
/**
* 初始化客服服务
*/
initCustomerService(config = null) {
this.customerService = createCustomerService(this, config || this.latestConfig);
this.platformConfig = this.customerService.refreshConfig(config || this.latestConfig);
this.buttonConfig = this.customerService.getButtonConfig();
},
/**
* 微信小程序:初始化服务类型(官方/自定义)
*/
initWeappServiceType() {
// #ifdef MP-WEIXIN
// 从buttonConfig中获取官方客服标识
this.weappOfficialService = this.buttonConfig?.openType === 'contact';
// #endif
},
/**
* 获取店铺电话
*/
getShopTel() {
uni.getStorage({
key: 'shopInfo',
success: (e) => {
if (e.data && e.data.mobile && /^1[3-9]\d{9}$/.test(e.data.mobile)) {
this.tel = e.data.mobile;
}
}
});
},
/**
* 拨打电话
*/
call() {
if (!this.tel || !/^1[3-9]\d{9}$/.test(this.tel)) {
uni.showToast({ title: '暂无有效联系电话', icon: 'none' });
return;
}
uni.makePhoneCall({
phoneNumber: this.tel,
fail: (err) => {
if (err.errMsg !== 'makePhoneCall:fail cancel') {
uni.showToast({ title: '拨号失败,请稍后重试', icon: 'none' });
}
}
});
},
/**
* H5客服点击逻辑保持不变
*/
async handleCustomerService() {
if (this.isH5) {
uni.showLoading({ title: '加载中...', mask: true });
try {
const newConfig = await this.getLatestConfig();
this.latestConfig = newConfig;
this.initCustomerService(newConfig);
this.customerService.handleCustomerClick();
} catch (e) {
uni.showToast({ title: '操作失败', icon: 'none' });
} finally {
uni.hideLoading();
}
} else {
// 小程序:直接调用客服逻辑
this.customerService.handleCustomerClick();
}
},
/**
* 微信小程序自定义客服点击逻辑
*/
handleWeappCustomerService() {
// #ifdef MP-WEIXIN
this.customerService.handleCustomerClick();
// #endif
}
}
};
</script>
<style lang="scss">
.container-box {
width: 100%;
<style scoped>
/* 父容器:不限制高度,避免挤压按钮 */
.fixed-box {
position: fixed;
right: 20rpx; /* 增加右侧边距,避免贴边 */
bottom: 200rpx;
z-index: 9999;
display: flex;
flex-direction: column;
align-items: center;
gap: 14rpx; /* 替代margin更稳定 */
}
.item-wrap {
border-radius: 10rpx;
/* 核心:强制按钮为正方形+正圆 */
.btn-item {
/* 宽高强制相等,必须是正方形 */
width: 88rpx !important;
height: 88rpx !important;
/* 强制正圆(优先级最高) */
border-radius: 50% !important;
/* 白色背景(确保是圆) */
background-color: #ffffff !important;
/* 背景图居中显示,不拉伸 */
background-size: 60% 60% !important;
background-position: center !important;
background-repeat: no-repeat !important;
/* 清除默认样式 */
border: none !important;
padding: 0 !important;
margin: 0 !important;
/* 居中内容 */
display: flex !important;
justify-content: center !important;
align-items: center !important;
/* 阴影增强视觉(可选) */
box-shadow: 0 2rpx 8rpx rgba(0,0,0,0.1);
}
/* 清除button标签的默认点击样式微信小程序/浏览器) */
.btn-item::after {
border: none !important;
}
.image-box {
border-radius: 10rpx;
}
.unread-badge {
position: absolute;
top: -5rpx;
right: -5rpx;
background: #ff4544;
color: #fff;
border-radius: 20rpx;
min-width: 30rpx;
height: 30rpx;
line-height: 30rpx;
text-align: center;
font-size: 10rpx;
padding: 0 8rpx;
box-shadow: 0 2rpx 10rpx rgba(255, 73, 72, 0.3);
z-index: 1;
}
image {
width: 100%;
height: auto;
border-radius: 10rpx;
will-change: transform;
}
}
}
/* 微信小程序字体适配 */
/* #ifdef MP-WEIXIN */
.unread-badge {
font-size: 20rpx;
}
/* #endif */
//悬浮按钮
.fixed-box {
position: fixed;
right: 0rpx;
bottom: 200rpx;
z-index: 10;
border-radius: 120rpx;
padding: 20rpx 0;
display: flex;
justify-content: center;
flex-direction: column;
width: 100rpx;
box-sizing: border-box;
transition: 0.3s;
overflow: hidden;
.btn-item {
display: flex;
justify-content: center;
align-items: center; /* 新增:让🤖表情垂直居中 */
text-align: center;
flex-direction: column;
line-height: 1;
margin: 14rpx 0;
transition: 0.1s;
background: #fff;
border-radius: 50rpx;
width: 80rpx;
height: 80rpx;
padding: 0;
position: relative;
text {
font-size: 36rpx;
font-weight: bold;
}
view {
font-size: 26rpx;
font-weight: bold;
}
&.show {
transform: rotate(180deg);
}
&.switch {}
&.icon-xiala {
margin: 0;
margin-top: 0.1rpx;
}
// 未读消息小红点
.unread-badge {
position: absolute;
top: -5rpx;
right: -5rpx;
background-color: #ff4544;
color: white;
border-radius: 20rpx;
min-width: 30rpx;
height: 30rpx;
font-size: 10rpx;
line-height: 30rpx;
text-align: center;
padding: 0 8rpx;
z-index: 1;
box-shadow: 0 2rpx 10rpx rgba(255, 69, 68, 0.3);
.badge-text {
font-size: 8rpx;
// #ifdef MP-WEIXIN
font-size: 20rpx;
// #endif
}
}
// AI图标样式优化让🤖表情居中显示
.ai-icon {
font-size: 40rpx; // 调整🤖表情大小
display: flex;
align-items: center;
justify-content: center;
width: 100%;
height: 100%;
}
}
}
.ai-icon {
font-size: 40rpx;
}
</style>

View File

@@ -1,171 +1,170 @@
<template>
<view class="contact-wrap">
<slot></slot>
<!-- #ifdef MP-ALIPAY -->
<view class="contact-button" @click="contactServicer">
<contact-button :tnt-inst-id="config.instid" :scene="config.scene" size="1000rpx" v-if="config.type == 'aliapp'"/>
</view>
<!-- #endif -->
<!-- #ifndef MP-ALIPAY -->
<button
type="default"
hover-class="none"
:open-type="openType"
class="contact-button"
@click="contactServicer"
:send-message-title="sendMessageTitle"
:send-message-path="sendMessagePath"
:send-message-img="sendMessageImg"
:show-message-card="true"></button>
<!-- #endif -->
<uni-popup ref="servicePopup" type="center">
<view class="service-popup-wrap">
<view class="head-wrap" @click="$refs.servicePopup.close()">
<text>联系客服</text>
<text class="iconfont icon-close"></text>
</view>
<view class="body-wrap">{{ siteInfo.site_tel ? '请联系客服,客服电话是' + siteInfo.site_tel : '抱歉,商家暂无客服,请线下联系' }}</view>
</view>
</uni-popup>
</view>
</template>
<!-- 客服组件 -->
<script>
export default {
name: 'ns-contact',
props: {
niushop: {
type: Object,
default: function() {
return {};
}
},
sendMessageTitle: {
type: String,
default: ''
},
sendMessagePath: {
type: String,
default: ''
},
sendMessageImg: {
type: String,
default: ''
}
},
data() {
return {
config: null,
openType: ''
};
},
created() {
if (this.servicerConfig) {
// #ifdef H5
this.config = this.servicerConfig.h5;
// #endif
// #ifdef MP-WEIXIN
this.config = this.servicerConfig.weapp;
if (this.config.type == 'weapp') this.openType = 'contact';
// #endif
// #ifdef MP-ALIPAY
this.config = this.servicerConfig.aliapp;
if (this.config.type == 'aliapp') this.openType = 'contact';
// #endif
}
},
methods: {
/**
* 联系客服
*/
contactServicer() {
if (this.config.type == 'none') {
this.$refs.servicePopup.open();
}
if (this.openType == 'contact') return;
switch (this.config.type) {
case 'wxwork':
// #ifdef H5
location.href = this.config.wxwork_url;
// #endif
// #ifdef MP-WEIXIN
wx.openCustomerServiceChat({
extInfo: { url: this.config.wxwork_url },
corpId: this.config.corpid,
showMessageCard: true,
sendMessageTitle: this.sendMessageTitle,
sendMessagePath: this.sendMessagePath,
sendMessageImg: this.sendMessageImg
});
// #endif
break;
case 'third':
location.href = this.config.third_url;
break;
case 'niushop':
this.$util.redirectTo('/pages_tool/chat/room', this.niushop);
break;
default:
this.makePhoneCall();
}
},
/**
* 店铺联系方式
*/
makePhoneCall() {
this.$api.sendRequest({
url: '/api/site/shopcontact',
success: res => {
if (res.code == 0 && res.data.mobile) uni.makePhoneCall({
phoneNumber: res.data
.mobile
});
}
});
}
}
};
</script>
<style lang="scss">
.contact-wrap {
width: 100%;
height: 100%;
position: relative;
.contact-button {
width: 100%;
height: 100%;
position: absolute;
left: 0;
top: 0;
z-index: 5;
padding: 0;
margin: 0;
opacity: 0;
overflow: hidden;
}
}
.service-popup-wrap {
width: 600rpx;
.head-wrap {
display: flex;
justify-content: space-between;
align-items: center;
padding: 0 30rpx;
height: 90rpx;
}
.body-wrap {
text-align: center;
padding: 30rpx;
height: 100rpx;
}
}
<template>
<view class="contact-wrap">
<slot></slot>
<!-- #ifdef MP-ALIPAY -->
<view class="contact-button" @click="contactServicer">
<contact-button :tnt-inst-id="config.instid" :scene="config.scene" size="1000rpx"
v-if="config.type == 'aliapp'" />
</view>
<!-- #endif -->
<!-- #ifdef MP-WEIXIN -->
<!-- 微信小程序官方客服按钮 -->
<button v-if="useOfficialService" type="default" hover-class="none" open-type="contact"
class="contact-button" sessionFrom="weapp" showMessageCard="true"
:send-message-title="sendMessageTitle" :send-message-path="sendMessagePath"
:send-message-img="sendMessageImg"></button>
<!-- 微信小程序自定义客服按钮 -->
<button v-else type="default" hover-class="none" class="contact-button" @click="contactServicer"></button>
<!-- #endif -->
<!-- #ifndef MP-WEIXIN && MP-ALIPAY -->
<!-- 其他平台保持原逻辑 -->
<button type="default" hover-class="none" :open-type="openType" class="contact-button" @click="contactServicer"
:send-message-title="sendMessageTitle" :send-message-path="sendMessagePath"
:send-message-img="sendMessageImg" :show-message-card="true"></button>
<!-- #endif -->
<uni-popup ref="servicePopup" type="center">
<view class="service-popup-wrap">
<view class="head-wrap" @click="$refs.servicePopup.close()">
<text>联系客服</text>
<text class="iconfont icon-close"></text>
</view>
<view class="body-wrap">{{ siteInfo.site_tel ? '请联系客服,客服电话是' + siteInfo.site_tel : '抱歉,商家暂无客服,请线下联系' }}
</view>
</view>
</uni-popup>
</view>
</template>
<!-- 客服组件 -->
<script>
import { createCustomerService } from '@/common/js/customer-service.js';
export default {
name: 'ns-contact',
props: {
niushop: {
type: Object,
default: function () {
return {};
}
},
sendMessageTitle: {
type: String,
default: ''
},
sendMessagePath: {
type: String,
default: ''
},
sendMessageImg: {
type: String,
default: ''
}
},
data() {
return {
customerService: null,
buttonConfig: null
};
},
computed: {
/**
* 是否使用官方客服
*/
useOfficialService() {
if (!this.buttonConfig) return true;
// #ifdef MP-WEIXIN
// 如果是微信小程序,检查配置
if (this.buttonConfig.type === 'weapp') {
// 默认使用官方客服除非明确设置为false
return this.buttonConfig.useOfficial !== false;
}
// #endif
return false;
},
/**
* 客服配置
*/
config() {
return this.customerService?.getPlatformConfig() || {};
},
/**
* 打开类型
*/
openType() {
return this.buttonConfig?.openType || '';
}
},
created() {
// 初始化客服服务
this.customerService = createCustomerService(this);
this.buttonConfig = this.customerService.getButtonConfig();
},
methods: {
/**
* 联系客服
*/
contactServicer() {
// 如果是微信/支付宝小程序客服,由系统自动处理
if (this.buttonConfig.openType === 'contact') {
return;
}
// 使用统一客服处理
this.customerService.handleCustomerClick({
niushop: this.niushop,
sendMessageTitle: this.sendMessageTitle,
sendMessagePath: this.sendMessagePath,
sendMessageImg: this.sendMessageImg
});
}
}
};
</script>
<style lang="scss">
.contact-wrap {
width: 100%;
height: 100%;
position: relative;
.contact-button {
width: 100%;
height: 100%;
position: absolute;
left: 0;
top: 0;
z-index: 5;
padding: 0;
margin: 0;
opacity: 0;
overflow: hidden;
}
}
.service-popup-wrap {
width: 600rpx;
.head-wrap {
display: flex;
justify-content: space-between;
align-items: center;
padding: 0 30rpx;
height: 90rpx;
}
.body-wrap {
text-align: center;
padding: 30rpx;
height: 100rpx;
}
}
</style>

View File

@@ -0,0 +1,66 @@
# 企业微信联系客服组件更新日志
## v2.0.0 - 集成全局Store配置
### 新增功能
- ✅ 企业微信配置集成到全局Store
- ✅ 从 `/api/config/init` 统一获取配置
- ✅ 支持props覆盖全局配置
- ✅ 优化配置获取逻辑
### 变更内容
1. **Store集成**
-`store/index.js` 中添加 `wxworkConfig` 状态
- 添加 `setWxworkConfig` mutation
-`init` action 中从 `/api/config/init` 获取企业微信配置
2. **组件优化**
- `wxwork-contact.vue` 组件现在优先从全局Store获取配置
- 支持通过props覆盖全局配置
- 移除单独的API调用使用统一配置
3. **页面集成**
- `pages/contact/contact.vue` 页面简化配置获取逻辑
- 直接使用全局Store中的企业微信配置
### 配置格式
后端 `/api/config/init` 需要返回以下格式的企业微信配置:
```json
{
"code": 0,
"data": {
// ... 其他配置 ...
"wxwork": {
"corp_id": "企业ID",
"agent_id": "应用ID",
"contact_id": "客服ID",
"contact_url": "活码链接",
"timestamp": "时间戳",
"nonceStr": "随机字符串",
"signature": "签名",
"enabled": true
}
}
}
```
### 使用方式
```vue
<!-- 使用全局配置 -->
<wxwork-contact btn-text="联系企业客服"></wxwork-contact>
<!-- 覆盖全局配置 -->
<wxwork-contact
:corp-id="customCorpId"
:contact-url="customContactUrl"
btn-text="自定义客服"></wxwork-contact>
```
## v1.0.0 - 初始版本
### 功能
- 企业微信JS-SDK封装
- 基础联系客服组件
- 支持小程序和H5环境
- 活码跳转和SDK两种方式

View File

@@ -0,0 +1,484 @@
# 企业微信联系客服组件
## 功能说明
这个组件实现了在小程序中点击"联系客服"后,自动跳转到企业微信添加对应销售的功能。
## 关键前提条件
### ⚠️ 重要提醒
微信小程序与企业微信互通有严格的平台限制和权限要求,使用前请确保满足以下所有条件:
### 1. 微信小程序环境要求
- **平台限制**:功能仅在微信小程序环境中可用
- **基础库版本**:需要微信小程序基础库 2.3.0 及以上版本
- **用户环境**:用户需要在微信中打开小程序
### 2. 企业微信配置要求
- **企业认证**:企业微信账号必须完成企业认证
- **客户联系功能**:需要开通企业微信"客户联系"功能
- **应用权限**:企业微信应用需要有客户联系相关权限
### 3. 互通配置要求
- **关联配置**:小程序必须与企业微信进行关联配置
- **权限申请**:需要在微信开放平台和企业微信后台分别申请相应权限
- **域名白名单**:相关域名需要在小程序和企业微信后台都配置白名单
### 4. 跳转权限要求
- **小程序AppID**需要在企业微信中配置允许跳转的小程序AppID
- **企业微信AppID**需要在微信开放平台配置关联的企业微信AppID
- **业务域授权**:需要配置业务域授权,允许跨平台跳转
### 5. 开发调试要求
- **测试环境**:需要在测试环境中验证跳转功能
- **权限验证**确保所有必要的API权限已申请并生效
- **兼容性测试**:在不同微信版本中进行兼容性测试
### 6. 具体配置要求
| 条件 | 说明 |
|------|------|
| **小程序与企业微信绑定** | 在企业微信管理后台 → 「应用管理」→「小程序」中关联你的微信小程序AppID |
| **配置可信域名** | 如果涉及网页跳转或回调,需在企业微信后台配置业务域名 |
| **使用企业微信服务商 or 自建应用** | 若需高级功能(如获取客户详情),需有企业微信管理员权限或通过服务商代开发 |
## 使用方法
### 1. 基础用法
```vue
<wxwork-contact
:corp-id="corpId"
:agent-id="agentId"
:timestamp="timestamp"
:nonce-str="nonceStr"
:signature="signature"
:contact-id="contactId"
:contact-url="contactUrl"
btn-text="添加企业微信客服">
</wxwork-contact>
```
### 组件架构
### 分层设计
```
调用方 (页面组件)
↓ 传递配置参数
wxwork-contact 组件
↓ 调用SDK
wxwork-jssdk.js
↓ 调用企业微信API
企业微信服务
```
### 组件设计原则
- **独立性**组件不直接依赖全局Store所有配置通过props传递
- **职责分离**组件只负责UI展示和企业微信SDK调用配置管理由调用方负责
- **灵活配置**:支持调用者覆盖任何配置参数
## 版本信息
### v3.0.0 - 统一客服服务重构版本
- 创建 `CustomerService` 统一客服处理服务
- 重构 `ns-contact.vue``hover-nav.vue` 消除重复代码
- 提供统一的客服处理接口和平台适配
- 完善错误处理和降级机制
- 支持所有客服类型的统一调用
### v2.0.0 - Store集成版本
- 企业微信配置集成到全局Store
-`/api/config/init` 统一获取配置
- 组件完全独立通过props接收配置
- 支持全局配置和局部覆盖
### v1.0.0 - 初始版本
- 基础企业微信联系功能
- 支持活码跳转和JS-SDK两种方式
### 2. 属性说明
| 属性 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| btnText | String | '添加企业微信客服' | 按钮文字 |
| corpId | String | - | 企业ID必需 |
| agentId | String | '' | 应用ID |
| timestamp | String | '' | 时间戳 |
| nonceStr | String | '' | 随机字符串 |
| signature | String | '' | 签名 |
| contactId | String | '' | 客服ID或活码配置ID |
| contactUrl | String | '' | 活码链接 |
| showConfirm | Boolean | true | 是否显示确认弹窗 |
### 3. 在联系页面中使用
`pages/contact/contact.vue` 中已集成使用示例:
```vue
<wxwork-contact
v-if="wxworkConfig && wxworkConfig.enabled"
:corp-id="wxworkConfig.corpId"
:agent-id="wxworkConfig.agentId"
:timestamp="wxworkConfig.timestamp"
:nonce-str="wxworkConfig.nonceStr"
:signature="wxworkConfig.signature"
:contact-id="wxworkConfig.contactId"
:contact-url="wxworkConfig.contactUrl"
btn-text="企业微信客服"
:show-confirm="false">
</wxwork-contact>
```
## 配置说明
### 后端接口需求
企业微信配置已集成到 `/api/config/init` 接口中,返回以下格式的数据:
```json
{
"code": 0,
"data": {
// ... 其他配置 ...
"wxwork": {
"corp_id": "企业ID",
"agent_id": "应用ID",
"contact_id": "客服ID",
"contact_url": "活码链接",
"timestamp": "时间戳",
"nonceStr": "随机字符串",
"signature": "签名",
"enabled": true
}
}
}
```
### 全局Store集成
企业微信配置通过以下方式集成到全局状态管理:
1. **Store状态**:在 `store/index.js` 中添加 `wxworkConfig` 状态
2. **配置获取**:在 `init` action 中从 `/api/config/init` 获取企业微信配置
3. **状态更新**:使用 `setWxworkConfig` mutation 更新配置
4. **持久化**:配置自动保存到本地存储
### 企业微信配置步骤
1. **获取企业微信活码**
- 登录企业微信管理后台
- 进入"客户联系" -> "配置" -> "联系我"
- 创建活码获取配置ID或直接获取活码链接
2. **配置参数**
- `corp_id`: 企业ID在企业微信后台获取
- `agent_id`: 企业微信应用ID
- `contact_id`: 客服的用户ID
- `contact_url`: 企业微信活码链接(推荐使用活码链接)
- `timestamp`: 生成签名的时间戳
- `nonceStr`: 生成签名的随机字符串
- `signature`: JS-SDK签名
## 典型业务流程示例
### 目标
用户在小程序中点击"联系客服",自动添加对应的企业微信销售。
### 步骤
1. **后端调用企业微信 API** 创建「联系我」二维码(可带场景值,如 user_id=123
2. **前端在小程序中展示该二维码(或生成跳转链接)**
3. **用户长按识别 → 打开企业微信 → 添加客服**
4. **企业微信收到添加事件 → 通过 API 获取 external_userid → 关联到原小程序用户**
## 实现原理
### 方案1企业微信活码跳转推荐
- 使用企业微信活码链接
- 通过 `uni.navigateToMiniProgram` 跳转到企业微信小程序
- 直接添加对应的销售为联系人
### 方案2JS-SDK方式
- 使用企业微信JS-SDK
- 调用 `openUserProfile` 接口打开用户资料
- 用户手动添加联系人
## 注意事项
### 功能限制
1. **小程序环境**:需要在微信小程序环境中使用
2. **权限配置**:确保小程序有跳转企业微信的权限
3. **降级处理**:当企业微信不可用时,会降级到原有客服方式
4. **用户体验**:建议添加确认弹窗,避免误操作
### 前提条件验证
5. **权限检查**:使用前需要验证所有必需权限是否生效
6. **配置完整性**:确保所有配置参数都已正确设置
7. **网络环境**:确保用户网络环境允许访问企业微信服务
8. **版本兼容**:检查微信版本和企业微信版本兼容性
### 调试建议
9. **错误监控**:添加适当的错误日志和用户反馈机制
10. **性能优化**避免频繁的SDK初始化和配置获取
11. **安全考虑**:敏感配置信息应在服务端处理,前端不暴露
## 兼容性
- 微信小程序:✅ 支持
- H5环境✅ 支持跳转活码链接
- 其他平台:降级处理
## 文件结构
```
components/wxwork-contact/
├── wxwork-contact.vue # 主组件
└── README.md # 说明文档
components/ns-contact/
└── ns-contact.vue # 统一客服组件(重构后)
components/hover-nav/
└── hover-nav.vue # 悬浮导航组件(重构后)
common/js/
├── wxwork-jssdk.js # 企业微信JS-SDK封装
└── customer-service.js # 客服统一处理服务(新增)
store/
└── index.js # 全局Store包含wxworkConfig状态管理
pages/contact/
└── contact.vue # 联系页面,集成企业微信功能
```
## 系统梳理与优化 (v3.1.0)
### 🔧 已修复的问题
#### 1. **App.vue 配置恢复**
- ✅ 修复了企业微信配置 (`wxworkConfig`) 在应用启动时的恢复
- ✅ 确保所有配置都能正确从本地存储恢复到Store
#### 2. **客服服务参数传递**
- ✅ 修复了 `openCustomerServiceChat` 参数传递错误
- ✅ 正确传递 `sendMessageTitle``sendMessagePath``sendMessageImg`
#### 3. **组件配置访问**
- ✅ 在 `ns-contact.vue``hover-nav.vue` 中添加 computed 属性
- ✅ 确保能够正确访问 `servicerConfig`
#### 4. **企业微信服务优化**
- ✅ 改进参数传递,支持自定义消息参数
- ✅ 统一处理函数调用方式
### 🛡️ 新增功能
#### 1. **配置验证机制**
```javascript
const validation = this.customerService.validateConfig();
if (!validation.isValid) {
// 处理配置错误
}
```
#### 2. **错误处理增强**
- ✅ 添加配置错误弹窗
- ✅ 改进错误日志记录
- ✅ 警告信息提示
#### 3. **类型安全**
- ✅ 完善参数类型检查
- ✅ 空值和异常情况处理
### 📋 当前系统状态
| 组件 | 状态 | 功能完整性 |
|------|------|-----------|
| **customer-service.js** | ✅ 完成 | 统一客服处理服务 |
| **ns-contact.vue** | ✅ 修复 | 支持所有客服类型 |
| **hover-nav.vue** | ✅ 修复 | 集成统一客服服务 |
| **App.vue** | ✅ 修复 | 配置完整恢复 |
| **contact.vue** | ⚠️ 待优化 | 仍使用原始方式 |
### 🔄 待优化项
#### 1. **contact.vue 页面重构**
- 建议集成统一客服服务
- 添加企业微信客服按钮
- 统一UI交互体验
#### 2. **加载状态反馈**
- 客服功能调用时的loading状态
- 网络请求的进度指示
#### 3. **用户体验优化**
- 客服按钮的点击反馈
- 错误状态的友好提示
### 🧪 测试建议
1. **配置验证测试**
- 测试各种配置缺失情况
- 验证错误提示准确性
2. **平台兼容测试**
- 微信小程序客服功能
- H5环境跳转
- 支付宝小程序客服
3. **企业微信功能测试**
- 活码链接跳转
- 降级处理机制
- 参数传递正确性
### 📖 使用最佳实践
```javascript
// 推荐使用方式
const customerService = createCustomerService(this);
// 带配置验证的调用
if (customerService.isConfigAvailable()) {
customerService.handleCustomerClick({
sendMessageTitle: '商品咨询',
sendMessagePath: '/pages/goods/detail',
sendMessageImg: 'product-image.jpg'
});
}
```
## 重构说明 (v3.0.0)
### 统一客服处理服务
为了解决代码重复问题,我们创建了 `CustomerService` 类来统一处理所有客服逻辑:
#### 主要改进
1. **代码复用**:消除 `ns-contact.vue``hover-nav.vue` 中的重复代码
2. **统一接口**提供一致的客服处理API
3. **平台适配**:自动处理不同平台的客服配置
4. **类型安全**:完善的错误处理和降级机制
#### 使用方式
**1. 在组件中导入**
```javascript
import { createCustomerService } from '@/common/js/customer-service.js';
```
**2. 初始化服务**
```javascript
created() {
this.customerService = createCustomerService(this);
this.buttonConfig = this.customerService.getButtonConfig();
}
```
**3. 处理客服点击**
```javascript
methods: {
contactServicer() {
this.customerService.handleCustomerClick({
niushop: this.niushop,
sendMessageTitle: this.sendMessageTitle,
sendMessagePath: this.sendMessagePath,
sendMessageImg: this.sendMessageImg
});
}
}
```
#### 核心方法
| 方法名 | 用途 | 参数 |
|--------|------|------|
| `handleCustomerClick(options)` | 统一处理客服点击 | 客服配置选项 |
| `getButtonConfig()` | 获取按钮配置 | - |
| `getServiceType()` | 获取客服类型 | - |
| `openWxworkService()` | 打开企业微信客服 | 是否使用原方式 |
#### 支持的客服类型
- `wxwork` - 企业微信客服
- `third` - 第三方客服
- `niushop` - 牛商客服
- `weapp` - 微信小程序客服
- `aliapp` - 支付宝小程序客服
- `none` - 无客服(显示提示)
## 常见问题 (FAQ)
### Q: contact_id 是小程序ID吗
A: 不是的。`contact_id` 是**企业微信中客服人员的用户ID**,具体说明如下:
- **定义**:企业微信系统内部分配给客服人员的唯一标识符
- **获取方式**:通过企业微信管理后台的"客户联系" → "配置" → "联系我"功能创建活码时获得
- **用途**:用于指定具体客服人员,当用户点击"联系客服"时系统通过这个ID知道应该添加哪个企业微信客服人员
### Q: contact_id 和小程序ID的区别
A: 两者的作用完全不同:
| 字段 | 用途 | 获取方式 |
|------|------|----------|
| **contact_id** | 指定具体的企业微信客服人员 | 企业微信管理后台获取 |
| **小程序AppID** | 识别整个微信小程序应用 | 微信开放平台获取 |
在业务流程中:
1. 用户在小程序中点击"联系客服"
2. 系统使用 `contact_id` 打开对应的企业微信客服人员资料
3. 用户添加该企业微信客服为联系人
所以 `contact_id` 是企业微信客服的ID不是小程序的ID。
### Q: wxwork_contact_url 从哪里来?
A: `wxwork_contact_url` 应该来自全局Store中的 `wxworkConfig`,而不是 `servicerConfig`
**正确的配置来源**
-`this.$store.state.wxworkConfig.contact_url` - 企业微信配置
-`this.config.wxwork_contact_url` - 错误的配置路径
**配置获取流程**
1. **后端接口**`/api/config/init` 返回 `wxwork_config` 数据
2. **Store存储**`setWxworkConfig` 将配置保存到 `wxworkConfig` 状态
3. **组件使用**:通过 `this.$store.state.wxworkConfig.contact_url` 访问
**代码修正示例**
```javascript
// 错误 ❌
if (this.config.wxwork_contact_url) { ... }
// 正确 ✅
const wxworkConfig = this.$store.state?.wxworkConfig;
if (wxworkConfig?.contact_url) { ... }
```
**字段对应关系**
| 后端字段 | Store字段 | 组件使用 |
|---------|----------|----------|
| `contact_url` | `contact_url` | `wxworkConfig.contact_url` |
### Q: navigateToMiniProgram 中的企业微信小程序AppID 是指我的业务小程序ID吗
A: 不是的!`appId: 'wxeb490c6f9b154ef9'` 是**企业微信官方小程序的AppID**不是你的业务小程序ID。
**两者的区别**
| 小程序类型 | AppID示例 | 用途 | 所有者 |
|-----------|----------|------|--------|
| **企业微信官方小程序** | `wxeb490c6f9b154ef9` | 展示企业联系人详情页面 | 腾讯企业微信团队 |
| **你的业务小程序** | 你的AppID | 你的业务功能(电商、服务等) | 你的企业/组织 |
**业务流程**
```
用户小程序 (你的业务)
↓ 点击"联系客服"
navigateToMiniProgram 跳转到
企业微信官方小程序 (wxeb490c6f9b154ef9)
↓ 展示联系人详情
用户添加客服人员到企业微信
```
**关键点**
- 这个AppID是企业微信官方小程序通常是固定值
- 用于跳转到企业微信环境展示联系人详情
- 不需要替换成你自己的小程序AppID |

View File

@@ -0,0 +1,301 @@
<template>
<view class="wxwork-contact-wrap">
<slot></slot>
<button
type="default"
hover-class="none"
class="contact-button"
@click="addWxWorkContact">
<text class="btn-text">{{ btnText }}</text>
</button>
<!-- 确认弹窗 -->
<uni-popup ref="confirmPopup" type="center">
<view class="confirm-popup">
<view class="popup-header">
<text>添加企业微信客服</text>
</view>
<view class="popup-body">
<text>点击确定后将跳转至企业微信添加专业客服为您服务</text>
</view>
<view class="popup-footer">
<button class="cancel-btn" @click="closePopup">取消</button>
<button class="confirm-btn" @click="confirmAdd">确定</button>
</view>
</view>
</uni-popup>
</view>
</template>
<script>
import { WxWork } from '@/common/js/wxwork-jssdk.js';
export default {
name: 'wxwork-contact',
props: {
// 按钮文字
btnText: {
type: String,
default: '添加企业微信客服'
},
// 企业ID必需
corpId: {
type: String,
required: true
},
// 应用ID
agentId: {
type: String,
default: ''
},
// 时间戳
timestamp: {
type: String,
default: ''
},
// 随机字符串
nonceStr: {
type: String,
default: ''
},
// 签名
signature: {
type: String,
default: ''
},
// 客服ID或活码配置ID
contactId: {
type: String,
default: ''
},
// 活码链接
contactUrl: {
type: String,
default: ''
},
// 是否显示确认弹窗
showConfirm: {
type: Boolean,
default: true
}
},
data() {
return {
wxWorkSDK: null
};
},
mounted() {
this.initWxWork();
},
methods: {
/**
* 初始化企业微信SDK
*/
initWxWork() {
try {
if (this.corpId) {
this.wxWorkSDK = new WxWork();
const initResult = this.wxWorkSDK.init({
corpId: this.corpId,
agentId: this.agentId,
timestamp: this.timestamp,
nonceStr: this.nonceStr,
signature: this.signature,
jsApiList: ['openUserProfile', 'openEnterpriseChat']
});
if (!initResult) {
console.error('企业微信SDK初始化失败');
}
}
} catch (error) {
console.error('初始化企业微信SDK失败:', error);
}
},
/**
* 点击添加企业微信客服
*/
addWxWorkContact() {
if (this.showConfirm) {
this.$refs.confirmPopup.open();
} else {
this.confirmAdd();
}
},
/**
* 确认添加
*/
confirmAdd() {
this.closePopup();
// 直接使用props传递的配置
const contactUrl = this.contactUrl;
const contactId = this.contactId;
// #ifdef MP-WEIXIN
if (contactUrl) {
// 方案1直接跳转到企业微信活码
this.jumpToWxWorkContact(contactUrl);
} else if (contactId) {
// 方案2使用SDK打开用户资料
this.openUserProfile(contactId);
} else {
this.showError('未配置企业微信客服信息');
}
// #endif
// #ifdef H5
if (contactUrl) {
// H5环境直接跳转
window.location.href = contactUrl;
} else {
this.showError('未配置企业微信客服信息');
}
// #endif
},
/**
* 跳转到企业微信客服
*/
jumpToWxWorkContact(contactUrl) {
uni.navigateToMiniProgram({
appId: 'wxeb490c6f9b154ef9', // 企业微信小程序AppID
path: `pages/contacts/externalContactDetail?url=${encodeURIComponent(contactUrl)}`,
success: () => {
console.log('跳转企业微信成功');
this.$util.showToast({
title: '跳转成功',
icon: 'success'
});
},
fail: (err) => {
console.error('跳转企业微信失败:', err);
this.showError('跳转失败,请检查企业微信配置');
}
});
},
/**
* 打开用户资料
*/
openUserProfile(contactId) {
if (!this.wxWorkSDK) {
this.showError('企业微信SDK未初始化');
return;
}
this.wxWorkSDK.addContact({
userId: contactId
}, (res) => {
console.log('打开用户资料成功:', res);
}, (err) => {
console.error('打开用户资料失败:', err);
this.showError('打开用户资料失败');
});
},
/**
* 显示错误提示
*/
showError(message) {
uni.showModal({
title: '提示',
content: message,
showCancel: false
});
},
/**
* 关闭弹窗
*/
closePopup() {
this.$refs.confirmPopup.close();
}
}
};
</script>
<style lang="scss" scoped>
.wxwork-contact-wrap {
width: 100%;
height: 100%;
position: relative;
.contact-button {
width: 100%;
height: 100%;
background: linear-gradient(135deg, #1e7dd8 0%, #1482e0 100%);
color: #fff;
border: none;
border-radius: 8rpx;
font-size: 28rpx;
display: flex;
align-items: center;
justify-content: center;
.btn-text {
font-weight: 500;
}
&:active {
opacity: 0.8;
}
}
}
.confirm-popup {
width: 600rpx;
background: #fff;
border-radius: 16rpx;
overflow: hidden;
.popup-header {
padding: 40rpx 30rpx 20rpx;
text-align: center;
font-size: 32rpx;
font-weight: 600;
color: #333;
border-bottom: 1px solid #f0f0f0;
}
.popup-body {
padding: 30rpx;
text-align: center;
font-size: 28rpx;
color: #666;
line-height: 1.6;
}
.popup-footer {
display: flex;
border-top: 1px solid #f0f0f0;
button {
flex: 1;
height: 88rpx;
line-height: 88rpx;
text-align: center;
font-size: 30rpx;
border: none;
border-radius: 0;
&.cancel-btn {
background: #fff;
color: #999;
border-right: 1px solid #f0f0f0;
}
&.confirm-btn {
background: #1e7dd8;
color: #fff;
}
&:active {
opacity: 0.8;
}
}
}
}
</style>

File diff suppressed because it is too large Load Diff

View File

@@ -146,8 +146,31 @@
nsNavbar,
toTop
},
mixins: [diyJs, scroll, indexJs]
mixins: [diyJs, scroll, indexJs],
methods: {
// 新增:电话按钮点击事件-弹出对话框
openCallDialog() {
uni.showModal({
title: "拨打?【仅为模拟】", // 弹窗标题
content: "", // 弹窗内容(可留空)
confirmText: "确定", // 确定按钮文字
cancelText: "取消", // 取消按钮文字
success: (res) => {
if (res.confirm) {
// 点击“确定”后的操作(比如实际拨号)
uni.makePhoneCall({
phoneNumber: "13800138000" // 替换为实际要拨打的号码
});
} else if (res.cancel) {
// 点击“取消”后的操作(可留空)
console.log('用户取消拨打');
}
}
});
}
}
};
</script>
<style lang="scss">

View File

@@ -50,8 +50,8 @@ const store = new Vuex.Store({
goods: '',
head: '',
store: '',
article: '',
aiAgent: ''
article: '',
aiAgent: ''
},
cartList: {},
cartIds: [],
@@ -67,6 +67,7 @@ const store = new Vuex.Store({
cartPosition: null, // 购物车所在位置
componentRefresh: 0, // 组件刷新
servicerConfig: null, // 客服配置
wxworkConfig: null, // 企业微信配置
diySeckillInterval: 0,
diyGroupPositionObj: {},
diyGroupShowModule: '',
@@ -167,6 +168,11 @@ const store = new Vuex.Store({
state.servicerConfig = value;
uni.setStorageSync('servicerConfig', value);
},
// 企业微信配置
setWxworkConfig(state, value) {
state.wxworkConfig = value;
uni.setStorageSync('wxworkConfig', value);
},
setDiySeckillInterval(state, value) {
state.diySeckillInterval = value;
},
@@ -232,6 +238,11 @@ const store = new Vuex.Store({
this.commit('setSiteInfo', data.site_info);
this.commit('setServicerConfig', data.servicer);
// 企业微信配置
if (data?.wxwork_config) {
this.commit('setWxworkConfig', data.wxwork_config);
}
this.commit('setCopyright', data.copyright);