WhatsApp 疑難排解
概述
本頁面提供 HelloClinic WhatsApp 功能的常見問題解決方案和疑難排解指南。
常見問題
連接問題
WhatsApp Business API 無法連接
問題描述：無法建立與 WhatsApp Business API 的連接
可能原因：
- API 金鑰設定錯誤
- 網路連線問題
- WhatsApp Business 帳戶未驗證
- 防火牆阻擋連接
解決方案：
- 檢查 API 金鑰是否正確設定
- 確認網路連線正常
- 驗證 WhatsApp Business 帳戶狀態
- 檢查防火牆設定，確保允許 WhatsApp API 連接
- 聯絡系統管理員確認伺服器設定
訊息發送失敗
問題描述：訊息無法成功發送給病患
可能原因：
- 收件人電話號碼格式錯誤
- 收件人已封鎖您的號碼
- WhatsApp Business 帳戶受限
- 訊息內容違反 WhatsApp 政策
解決方案：
- 確認電話號碼格式正確（包含國碼）
- 請病患檢查是否誤封鎖您的號碼
- 檢查 WhatsApp Business 帳戶狀態
- 確認訊息內容符合 WhatsApp 使用政策
- 嘗試發送測試訊息到已知正常的號碼
設定問題
WhatsApp 範本訊息無法使用
問題描述：預設的訊息範本無法正常使用
可能原因：
- 範本未經 WhatsApp 審核通過
- 範本格式不正確
- 範本已過期或被停用
解決方案：
- 檢查範本審核狀態
- 確認範本格式符合 WhatsApp 要求
- 重新提交範本審核
- 使用已通過審核的範本
- 聯絡 WhatsApp Business 支援
自動回覆功能異常
問題描述：自動回覆功能無法正常運作
可能原因：
- 自動回覆規則設定錯誤
- 關鍵字匹配問題
- 系統時間設定問題
解決方案：
- 檢查自動回覆規則設定
- 確認關鍵字匹配邏輯
- 檢查系統時間設定
- 測試自動回覆功能
- 重新設定自動回覆規則
同步問題
訊息記錄不同步
問題描述：WhatsApp 訊息記錄與 HelloClinic 系統不同步
可能原因：
- 網路連線不穩定
- 系統同步設定問題
- 資料庫連接問題
解決方案：
- 檢查網路連線穩定性
- 確認同步設定正確
- 檢查資料庫連接狀態
- 手動觸發同步
- 聯絡技術支援協助
聯絡人資訊不更新
問題描述：病患聯絡人資訊無法自動更新
可能原因：
- 權限設定問題
- 資料同步延遲
- 聯絡人隱私設定
解決方案：
- 檢查權限設定
- 等待系統自動同步
- 手動更新聯絡人資訊
- 確認病患隱私設定
- 重新整理聯絡人清單
效能優化
提升訊息發送速度
- 批次發送：使用批次發送功能處理大量訊息
- 排程發送：避開高峰時段發送訊息
- 範本優化：使用簡潔的訊息範本
- 網路優化：確保穩定的網路連線
減少錯誤率
- 號碼驗證：發送前驗證電話號碼格式
- 內容檢查：確認訊息內容符合政策
- 定期測試：定期測試 WhatsApp 功能
- 監控狀態：監控 API 連接狀態
最佳實務
訊息管理
- 使用標準化的訊息範本
- 定期清理過期的訊息記錄
- 建立訊息分類和標籤系統
- 設定適當的訊息保留期限
隱私保護
- 遵守個人資料保護法規
- 獲得病患同意後才發送訊息
- 定期檢查隱私設定
- 安全處理敏感資訊
合規要求
- 遵守 WhatsApp Business 使用條款
- 確保訊息內容合法合規
- 定期更新政策和程序
- 保持 API 版本更新
錯誤代碼參考
| 錯誤代碼 | 說明 | 解決方案 |
|---|---|---|
| 1001 | API 金鑰無效 | 檢查並更新 API 金鑰 |
| 1002 | 號碼格式錯誤 | 確認電話號碼格式 |
| 1003 | 訊息範本未審核 | 等待範本審核通過 |
| 1004 | 發送頻率過高 | 降低發送頻率 |
| 1005 | 帳戶受限 | 聯絡 WhatsApp 支援 |
聯絡支援
如果以上解決方案無法解決您的問題，請聯絡我們的技術支援團隊：
- 郵箱：support@helloclinic.io
- 電話：+886-2-XXXX-XXXX
- 線上客服：週一至週五 9:00-18:00
- 緊急支援：24/7 技術熱線