开源客户沟通平台Chatwoot

在这里插入图片描述

什么是 Chatwoot ？

Chatwoot 是一个开源客户沟通平台，可帮助公司在其网站、Facebook 页面、Twitter、Whatsapp、SMS、电子邮件等上吸引客户。它是 Intercom、Zendesk、Salesforce Service Cloud 等的开源替代品。

很多网站的右侧或者右下角，都会有一个 联系我们 按钮，除了电话或者微信外，还可以留言或者直接与客服在线聊天，而要实现这些功能，就需要用到我们今天介绍的客户沟通平台 Chatwoot，它为我们提供了从一个地方管理对话、建立关系和取悦客户的所有工具。

在这里插入图片描述

除了网页外，Chatwoot for mobile 还支持在 Android 和 iOS上使用，使您能够浏览对话、回复消息并与您的团队合作。

在这里插入图片描述

命令行安装

如果你熟悉命令行，可以用 docker-compose 安装，但是需要注意的事，在低版本内核上，还是会遇到随机数错误。原因在于SecureRandom 模块生成随机数时没有成功获取 urandom。

SecureRandom 是一个 Ruby 标准库，用于生成随机数，通常使用操作系统提供的随机数生成器。在这个错误中，SecureRandom 无法获取所需的随机数，因此导致应用程序无法正常运行。

新建安装目录

# 新建文件夹 chatwoot 和 子目录
mkdir -p /volume1/docker/chatwoot/{postgres,redis,storage}# 进入 chatwoot 目录
cd /volume1/docker/chatwoot

env.txt 文件

首选需要 env.txt 文件，官方的样例文件在：https://raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example，你可以在本地复制粘贴生成后，上传到 chatwoot 目录，也可以直接用下面的命令下载

# 下载 env.txt
wget -O env.txt https://raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example# 下不动的话可以加个代理
wget -O env.txt https://ghproxy.com/raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example

虽然参数很多，但是要跑起来，需要修改的并不多

SECRET_KEY_BASE：可以用命令 openssl rand -base64 32 来生成；
FRONTEND_URL：如果局域网使用可以用 IP:port，例如：http://192.168.0.199:3338，公网使用直接就用域名，例如：https://chatwoot.laosu.ml:444
POSTGRES_PASSWORD：PostgresSQL 数据库的密码，虽然老苏把对外暴露的端口关闭了，但还是建议密码复杂一点；
邮件部分应该是找回密码用的，老苏设置了，但没测试；

老苏将用到的 env.txt 文件和 docker-compose.yml 放到了 https://github.com/wbsu2003/synology/tree/main/Chatwoot，方便大家对比着看

docker-compose.yml

官方的示例：https://raw.githubusercontent.com/chatwoot/chatwoot/develop/docker-compose.production.yaml

你可以下载下来自己修改

# 下载 docker-compose.yml
wget -O docker-compose.yml https://raw.githubusercontent.com/chatwoot/chatwoot/develop/docker-compose.production.yaml# 下不动的话可以加个代理
wget -O docker-compose.yml https://ghproxy.com/raw.githubusercontent.com/chatwoot/chatwoot/develop/docker-compose.production.yaml

也可以直接将下面老苏修改后的内容保存为 docker-compose.yml 文件

version: '3'services:base: &baseimage: chatwoot/chatwoot:latest#container_name: chatwoot-baseenv_file: env.txt ## Change this file for customized env variablesvolumes:- ./storage:/app/storagerails:<<: *basedepends_on:- postgres- redisports:- 3338:3000environment:- NODE_ENV=production- RAILS_ENV=production- INSTALLATION_ENV=dockerentrypoint: docker/entrypoints/rails.shcommand: ['bundle', 'exec', 'rails', 's', '-p', '3000', '-b', '0.0.0.0']sidekiq:<<: *basedepends_on:- postgres- redisenvironment:- NODE_ENV=production- RAILS_ENV=production- INSTALLATION_ENV=dockercommand: ['bundle', 'exec', 'sidekiq', '-C', 'config/sidekiq.yml']postgres:image: postgres:14container_name: chatwoot-postgresrestart: always#ports:#  - 5432:5432volumes:- ./postgres:/var/lib/postgresql/dataenvironment:- POSTGRES_DB=chatwoot- POSTGRES_USER=postgres# Please provide your own password.- POSTGRES_PASSWORD=postgresredis:image: redis:6.2-alpinecontainer_name: chatwoot-redisrestart: alwayscommand: ["sh", "-c", "redis-server --requirepass \"$REDIS_PASSWORD\""]env_file: env.txtvolumes:- ./redis:/data#ports:#  - 6379:6379

将 docker-compose.yml 和 env.txt 放入当前目录

在这里插入图片描述

然后执行下面的命令创建数据库

# 通过运行迁移来准备数据库
docker-compose run --rm rails bundle exec rails db:chatwoot_prepare

在这里插入图片描述

看到 Created database 'chatwoot_production'，表示数据库创建成功了，继续执行下面的命令

# 需要先删除数据库容器
docker-compose down# 一键启动
docker-compose up -d

在这里插入图片描述

运行

在浏览器中输入 http://群晖IP:3338 就能看到注册界面

在这里插入图片描述

注册成功之后需要登录

在这里插入图片描述

登录成功之后的主界面

在这里插入图片描述

中文

Settings --> Account Setting --> Site language，下拉找到简体中文

在这里插入图片描述

点右上角的绿色按钮 Update settings 保存设置

在这里插入图片描述

现在大部分界面已经是中文了

客户服务渠道

会话 --> 收件箱 --> New inbox

在这里插入图片描述

选择 Website

在这里插入图片描述

用公司的网站做个测试

在这里插入图片描述

目前系统只有一个用户，所以选择只能选择其作为 客服代理

在这里插入图片描述

现在生成了一段代码

在这里插入图片描述

    <script>(function(d,t) {var BASE_URL="https://chatwoot.laosu.ml:444";var g=d.createElement(t),s=d.getElementsByTagName(t)[0];g.src=BASE_URL+"/packs/js/sdk.js";g.defer = true;g.async = true;s.parentNode.insertBefore(g,s);g.onload=function(){window.chatwootSDK.run({websiteToken: 'JTuCfhUYpGL1g1EkwNCiUxjM',baseUrl: BASE_URL})}})(document,"script");</script>

添加代码到网站

将上面这段收件箱脚本，粘贴到网站的页面的<body>标记中，刷新页面后，就可以开始留言了

在这里插入图片描述

后台可以直接回复

在这里插入图片描述

参考文档

chatwoot/chatwoot: Open-source customer engagement suite, an alternative to Intercom, Zendesk, Salesforce Service Cloud etc. 🔥💬
地址：https://github.com/chatwoot/chatwoot