[VtigerCRM][設定] Vtiger 5.4.0 信件功能設定

[抒發文]
這段時間在公司整理Vtiger 舊系統資料與新系統之間的轉移，同時也花比較多時間來設計PDF樣式。終於四種PDF的版型設計好了也能正常運作，也花了時間對公司同仁做操作上的員工訓練。結果反而額外要求更多功能可能= ="......其中有提到關於Mail的通知功能，希望能夠直接透過Vtiger來將客戶資料直接發信給Sales。原則上這沒啥問題，只是需要時間來設定而已。廢話不多說，這裡收集所有跟Mail有關的設定！

原則來說Vtiger 5.4.0 對於E-Mail的應用方式可以簡述下列幾種模式：

1. 可以讓使用者直接在Vtiger透過IMAP讀取個人信箱與操作 (WebMail)
2. 可以直接對多個存在的客戶直接發信通知 (行銷廣告)
3. 可以提醒(assigned to) Sales 某一筆客戶資料傳送到Sales mail
4. 配合行事曆以Mail通知User相關任務
5. 透過Workflow來達到某條件下發送Mail給指定的User讀取某數據 (這功能才是CRM核心需求)

以上來說第5點才是主要重點，如果第5點沒設定好，大概只能使用第1.2點的功能而已。而在第5點對我來說有碰到無法運作的相同狀況，這跟的Web環境有關有所影響(後敘)。光要排除這裡的狀況花了我一天時間猛咬原文論壇。反而中文網站有Vtiger的討論很少幾乎沒有，我也不寄望有中文環境可討論互助(嘆)，不知道這現象是不是國內沒人喜歡自己架VCRM。都是直接買CRM服務比較實際？Vtiger其實很好用，實際架起來並沒有多難.....(惑)
[抒發文]

---

由於公司使用Gmail Apps來管理，這裡我會用Gmail來示範Mail設定。如果你有其他類型Mail Server要設定可能要自己想辦法(沒有環境能測)。設定請根據以下步驟來逐步完成

1. 設定Vtiger的外寄代理伺服器
   這裡是系統本身的外寄處理，主要給系統作為通知用的。圖為Gmail的SSL設定方式 ，透過『CRM設置>系統設置 > 外寄服務器』設定。當設定完成後，會收到一封以你的名義發送測試信給自己。
   
   
2. 設定使用者的WebMail管理
   能夠允許每一個User在Vtiger讀取自己或公司信箱，好處在於當你在Vtiger所開啟的mail資訊儲存為客戶/連絡人或者進行關聯性資料，這會比較方便快速。圖為Gmail的IMAP示範，點選『工具>郵件管理>(設置)>選擇帳戶類型>Gmail』
   
   
   
   相對於以前舊版的mail會碰到亂碼問題已經沒了。只不過Gmail裡的文件夾還是亂碼。我也懶得調整改善(=3=)
   
   

---

大致上到這裡可以呼攏膚淺的人了，原則上對一般使用者來說能夠執行運作，也能對客戶資料進行廣告信作業，說穿是因為有設定Mail代理，能夠對所有的CRM資料移轉+收發信的各種可能...

重頭戲來了，如果你跟我老闆一樣難搞，希望每增加一筆新客戶時會自動發送這個客戶資料給負責人Sales(部門)，方便Sales對這個客戶作接洽。那麼你得依賴Workflow來成立，Workflow工作流主要是當某條件發生時，直接系統內部自動處理某事件。因此我得將需求轉換為Workflow項目來滿足。之前示範如何用Workflow進行資料欄位的判斷變化，這裡變成條件成立時將客戶資料傳送mail給Sales。

示範：透過Workflow，當Leads客戶成立時需傳送給負責人Sales

1. 

首先確保你的作業環境到底能不能被允許自動派信，Workflow要發信其實還得配合Scheduler+Cron來控制排程時間執行。因此隨著作業環境不同要調整的方式也不一樣。先檢查『系統設置>Scheduler』的項目裡有沒有曾經被執行成功過，造理來說運行一段時間，你的畫面應該要有顯示運行時間狀況(圖)

我不知道是不是初安裝的時候Vtiger會應該幫忙設定好這裡，因為我的原本一直沒顯示代表Scheduler時間調度一直是不能運作。所以依照官方WIKI碰到這問題，需要設定OS環境的工作排程：換句話說你得想辦法將OS的Scheduler跟Vtiger的Scheduler能夠搭上

參考原文Scheduler的設定方式 https://wiki.vtiger.com/index.php/Cron

這裡不多敘述步驟且連結清楚寫明，簡單說明分為 Windows設定方式 與 Linux設定方式，你要讓OS在指定時間內去執行Vtiger內的Cron腳本，Vtiger才會運作Scheduler的工作調度。腳本位置如下

Windows  >>  cron\vtigercron.bat   (請添加這個命令到Windows的工作排程裡)

Linux  >>  cron\vtigercron.sh           (請添加這個命令到Linux的crontab裡)

因此OS的部分為，Windows需要透過工作排程來排程這個cron才能執行Vtiger的Scheduler。Linux的話一樣也要使用crontab -e 這個指令來增加一筆cron去執行。

但問題來了，在官方的cron腳本設定指導與作法，其實需依賴php-cli來滿足OS是否能執行vtger 的PHP控制cron腳本。因此需額外去判斷你的OS到底有沒有支援php-cli....我的環境是Linux，因此透過SSL與Telnet方式下達命令     (-如果有結果就是有支援)

 [~] # php -v                            
 PHP 5.2.8 (cli) (built: Dec 10 2008 14:11:24)   
 Copyright (c) 1997-2008 The PHP Group  
 Zend Engine v2.2.0, Copyright (c) 1998-2008 Zend Technologies  
 [~] #   

不懂我說的php-cli是什麼？這裡的文篇寫很清楚與原理

http://www.akcms.com/manual/php-cli-windows-linux.htm

而偏偏我的Web OS是利用QNAP的NAS來架設，因此我沒有php的命令環境參數來運行。環境特殊且限制多所以不能加裝與硬上，所以不論我怎麼試QNAP的OS就是看不懂PHP。因此還有別的方法可行。

直接改掉原本的vtigercron.sh的寫法，全部清除原code，只寫成

 wget "http://localhost/vtigercron.php" -O /dev/null  

讓OS去執行這個webpage就好，用遊覽器來執行PHP最快。接著因為沒有使用php-cli的方式也取不到執行條件，所以連這個網頁vtigercron.php我們也要改原本的執行條件

更改

 if(PHP_SAPI === "cli" || (isset($_SESSION["authenticated_user_id"]) && isset($_SESSION["app_unique_key"]) && $_SESSION["app_unique_key"] == $application_unique_key)){  

變成寫法1

 if(PHP_SAPI === "cli" || !isset($_SERVER['REMOTE_ADDR']) || (isset($_SESSION["authenticated_user_id"]) && isset($_SESSION["app_unique_key"]) && $_SESSION["app_unique_key"] == $application_unique_key)){  

或寫法2

 if(PHP_SAPI === "cli" || (isset($_ENV['SHELL']) && $_ENV['SHELL'] === "/bin/sh") || (isset($_SESSION["authenticated_user_id"]) && isset($_SESSION["app_unique_key"]) && $_SESSION["app_unique_key"] == $application_unique_key)){  

所以我的作法是 (不支援php-cli的人可參考)

1. 一樣需用SSH來設定crontab 增加下列指令( 前面是時間 ，後面那一坨是Debug用，這樣才知道執行結果)

 */1 * * * * /share/MD0_DATA/Web/vcrm5/cron/vtigercron.sh 2>/share/MD0_DATA/Web/vcrm5/cron/debug.log 1>2  

2. 調整vtigercron.sh的寫法

3. 調整vtigercron.php的寫法

4. 同時需注意vtigercron.sh與vtigercron.php的權限要改成755

5. 可透過遊覽器執行看看第3點的路徑，如果出現INFO的訊息代表cron是可以手動執行的

6. 所以滿足動作1~4，接著讓OS自己執行動作5，這樣每一段時間都能執行結果出來囉

小插曲
運作大概2個月，偶爾會發幾次生無法發送Mail(cron不執行)。需要重新啟動Apache才能運作正常。突然又有一次不執行，檢查tigercron.php網頁出現Access denied!，重啟Apache也不行，查一下論壇跟我一樣的人困惱挺多，目前急著要運作，所以乾脆把剛剛的if敘述改成

if(ture){

這是強迫無條件執行的笨方法，希望有人可以指導我問題在哪?

---

關閉故障單的客戶通知

一段時間使用，發現預設的Vtiger會對成立的故障單做兩件事情，分別是寄件給"負責人"與"聯絡人"的信箱裡去。原本這機制是讓客戶能夠感受到售後服務的問題處理追蹤（我覺得蠻好的），但絕大部分的老闆併不希望讓客戶知道產品問題處理。因此，這裡告訴各位如何取消故障單的通知：

在舊版本之前，你需要手動對Code調整，說明網址在這！因為不少外國人論壇反應，所以5.4.0已經改到Workflow裡去，如不需要直接停用即可，透過

CRM設置>作業區>模塊管理>故障單>工作流列表，所有分別各項為：

Module	Description	Tools
故障單	Workflow for Ticket Created from Portal
故障單	Workflow for Ticket Updated from Portal
故障單	Workflow for Ticket Change, not from the Portal

進入各個Tools內，點選任務進行停用！一共有四個任務，分別是在新建/修改以及Protal用戶的情況下處理。


完成！待續整理