開發升訊威線上客服系統啟示錄:怎樣編寫堪比 MSDN 的使用者手冊

曹旭升(sheng.c)發表於2022-02-03

本系列文章詳細介紹使用 .net core 和 WPF 開發 升訊威線上客服與營銷系統 的過程。

免費線上使用 & 免費私有化部署:https://kf.shengxunwei.com


文章目錄列表請點選這裡


視訊實拍:演示升訊威線上客服系統在網路中斷,直接禁用網路卡,拔掉網線的情況下,也不丟訊息,不出異常。
https://blog.shengxunwei.com/Home/Post/fe432a51-337c-4558-b9e8-347b58cbcd53


不忘初心 方得始終:開源、免費、共享 之精神 ♥

大部分程式設計師都不愛寫文件,但是為了能讓使用者快速瞭解產品,提供指引。好的文件和好的產品一樣重要。

既然說產品要容易使用,為什麼又講到要有完善的文件和說明書呢。你要為使用者的使用設計一個遞進的層次。往往使用者是在直接體驗,感覺良好之後,才有可能看你的文件和說明書。所以兩者不矛盾。

使用者根據文件,就能自己完成系統的搭建,一方面使我能夠積累到更多的使用者,另一方面也減輕了我自己的精力,在有詳細文件之前,需要花很多時間回答使用者的疑問。

詳細的文件為我默默積累了許多前期使用者,對於大部分人來說,如果沒有詳細的文件,他們會直接放棄使用你的產品,而不是來諮詢你,這一點很重要。

我歸納為以下幾點:

  • 要有好的線上文件系統
  • 仔細設計文件結構
  • 認真編寫文件內容
  • 認真對待所有使用者的每一個問題

下面我仔細講講我是怎麼做的。

要有好的線上文件系統

首先我 花了大約 35分鐘 時間,寫了一個線上文件平臺,功能簡單,但是做到了版式簡明,內容展示清晰。

https://docs.shengxunwei.com/Post/f7bc8496-14ee-4a53-07b4-08d8e3da6269

仔細設計文件結構

我仔細設計了文件的類目結構,一步一步分解了軟體的部署和使用過程。
特別是對於私有化部署的過程,我按 部署新伺服器、升級現有伺服器、伺服器維護 等幾個大類別,分開進行了詳細說明。
在每個大類別下,我又按 Windows、Linux、寶塔、Docker 不同的平臺,進一步詳細說明。

認真編寫文件內容

首先,是簡單易懂,圖文並茂

不搞玄學,不預設使用者是否有經驗。一切從 0 開始講解。每一步都以配圖加文字的方式詳細講解。

其次,是嚴謹認真

對於安裝部署的過程,我新開環境乾淨的伺服器,一邊實際操作,一邊對照寫文件。寫完之後,釋放伺服器環境再次重置,然後嚴格跟著文件再次驗證,發現有疏漏的地方就立即補充修改。

認真對待所有使用者的每一個問題

在平時收到使用者的問題,我從來沒有“怎麼這都不會”,“怎麼這都不知道”這類的想法。
不管什麼問題,我都會認真回答,並更新到線上文件中去。經過一段時間的積累,文件越來越完善。

收到使用者的熱心反饋

在文件上線一段時間後,陸續有使用者向我提供積極的反饋。

做為一個程式設計師,還有什麼比這更有成就感的事情呢?


不忘初心 方得始終:開源、免費、共享 之精神


  • 可以追蹤正在訪問網站或使用 APP 的所有訪客,收集他們的瀏覽情況,使客服能夠主動出擊,施展話術,促進成單。
  • 訪客端在 PC 支援包括 IE8 在內的所有瀏覽器。
  • 移動端支援手機瀏覽器、APP、各大平臺的公眾號。
  • 具備一線專業技術水平,網路中斷,拔掉網線,手機飛航模式,不丟訊息。同類軟體可以按視訊方式對比測試。
    ** 優酷視訊:https://v.youku.com/v_show/id_XNTEwNzQ5Mzg2OA==.html
    ** bilibili 視訊:https://www.bilibili.com/video/BV1pK4y1N7UP?t=22

相關文章