接入微信小程序

接入前提:小程序必须是经过认证的且非个人的;

接入成功后,你就可以在来鼓工作台统一接收和回复小程序用户的消息了。

一、接入方式 #

接入方式有三种:1. 授权接入;2. 自定义网址接入小程序;3. JS插件接入小程序

这三种接入方式的区别是:

第1种采用的是微信提供的聊天窗口,消息类型受微信限制;

第2、3种:采用的是来鼓的聊天窗口,消息类型更丰富,但需要企业具备一定的开发能力!

你可以按照业务需求选择最合适简便的接入方案。

1. 授权接入 #

配置入口:来鼓工作台【设置-接入-微信小程序】进行配置,

你可以选择【手动接入】或【扫码接入】方式;

1.1 扫码接入(最推荐⭐) #

这种方式最简单,点击【扫码接入微信小程序】,使用公众平台绑定的管理员个人微信扫码授权即可;

接入成功后,在小程序后台写一个咨询按钮(需要前端开发支持),用户通过此按钮即可进入对话;

参考微信官方文档:https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/customer-message/customer-message.html

button组件:https://developers.weixin.qq.com/miniprogram/dev/component/button.html

👇可以参考我们给出的代码示例:

(ps:这里传递的信息是小程序用户的信息)

<button class="grant cBtn" open-type="contact" session-from='{"name":"songyao","tel":"333334232323"}' >传信息</button>

1.2 手动接入 #

选择手动接入微信小程序,需要填写以下基本信息👇

*获取小程序基本信息的位置*

进入微信公众号后台—开发—开发设置】获取相关信息。

接入成功后,后续的操作跟扫码接入一样,请朝上翻👆 1.1 扫码接入

2. 自定义网址接入小程序 #

注:需要前端开发人员支持

自定义网址接入小程序,使用的是来鼓的聊天窗口;目前自定义网址可以放校验文件,以便小程序里面可以接入来鼓的聊天链接(来鼓工作台设置-接入-聊天链接)

配置步骤:

① 在小程序后台配置业务域名的地方下载校验文件

② 上传校验文件到企业自己的服务器根目录(自定义网址域名的根目录)

③ 验证上传校验文件是否成功:上传校验文件后,使用域名/校验文件.txt 的方式,访问看看是否可以正常返回数据。如果正常返回说明校验文件放置成功。

备注:小程序里面配置域名(注意:配置的域名一定要完全一模一样, 如果配置有问题,小程序里会提示无法访问,根据提示重新配置业务域名)

例如:自定义网址是 https://laigukf.com/chatlink.html,小程序后台配置的业务域名是  https://www.laigukf.com  这样是不行的,必须完全一样,业务域名正确应该配置成 https://laigukf.com/

3. JS 插件接入 #

注:需要前端开发人员支持

方法如下:

在小程序中用 webview,写一个 H5 页面,然后用来鼓提供的 JS 插件代码(来鼓工作台:设置-接入-网页插件)

如何使用 webview加载H5页面:

① 首先,写出一行代码:

<web-view src="https://www.baidu.com"></web-view>

② 只需要将src换成需要加载的页面路径就行了。在这里要提一下,路径前必须得加上协议名,不然就会报错。

<web-view src="www.baidu.com"></web-view>

如下图:

小程序如何打开H5页面,请参考微信开发社区文档:https://developers.weixin.qq.com/community/develop/doc/000caa7ffecb506b998b1afe15a400?highLine=%25E5%25B0%258F%25E7%25A8%258B%25E5%25BA%258F%25E6%2589%2593%25E5%25BC%2580h