設計手冊
設計手冊
設定傳送即時訊息後，使用者可在表單中按下按鈕，將資料庫中的值自動套用至系統管理者設計的訊息格式，並傳送給指定人員。與 Ragic 既有的分享或通知功能不同，此功能提供更高的客製化彈性，目前可透過 LINE 或 SMS 傳送訊息，例如傳送客製化繳費通知、向追蹤者推送促銷訊息與公告，或傳送預約提醒。
在表單頁的設計模式下，點選表單工具從自訂按鈕中找到傳送即時訊息。
在設定視窗中選擇要傳送的訊息種類：SMS 簡訊或 LINE 訊息。
此功能僅限專業版以上用戶使用，並需購買簡訊點數，即可透過 SMS 簡訊傳送客製化的預約通知、行銷訊息或取件通知等。
選擇 SMS 簡訊後，如果是第一次使用傳送簡訊功能的話會需要先填寫表單經過審核確認簡訊目的正當。
審核過後就可以開始設定簡訊內容：
1. 收訊人：請填入包含國碼的電話號碼（格式如 +886922333444）。若使用「選擇欄位」模式，可參考此章節調整電話號碼格式。可填入多組電話，或選擇多個欄位。請注意，每封簡訊的收訊人數上限為 20 人。
2. 內文：請注意簡訊字數上限為半形英數混合 160 字元（或中英文數字混合限制 70 個字），含標點符號。如超過字數限制，系統會將簡訊拆成不同封寄送，以封計費。相關說明請參考此章節。可搭配參數使用。支援參數請參考這裡。
備註：簡訊收費說明請參考此章節。
1. 不支援私有主機版（選項會顯示為灰色）。
2. 台灣號碼（透過三竹傳送）不支援在簡訊中放入網址。
3. 簡訊點數會依照三竹（簡訊商）後台顯示紀錄扣點，若三竹後台顯示傳送失敗，簡訊點數會回補回去。
除了使用即時傳送 SMS 簡訊按鈕外，使用者也可以在列表頁篩選多筆資料，一次執行發送大量簡訊。兩者的差異請參考下表：
| 功能 | 適用情境與特色 | 操作介面 | 設定者 |
|---|---|---|---|
| 即時傳送 SMS 簡訊 |
適用於客製化訊息 可單筆或批次執行（可設定多個收訊者或批次執行動作按鈕） 可儲存多個範本 支援變數 |
表單頁
列表頁 |
SYSAdmin |
| 發送大量簡訊 |
適合快速群發相同內容 主要用於批次發送，單筆操作不便 無法儲存範本 不支援變數 |
僅列表頁 | 使用者 |
可以透過自己公司的 LINE 官方帳號傳送 LINE 訊息，例如使用官方帳號傳送優惠活動通知、傳送服務預約通知、訂金繳費通知等等。
選擇 LINE 訊息後，請填入以下欄位：
1. Channel Access Token：
(1) 可看作讓系統代表你的 LINE 官方帳號傳送訊息的金鑰。請至 LINE Developers 後台複製貼上，確保 Token 權限正確。若沒有做過相關設定，可參考相關文件，了解如何啟用 Messaging API 並發行 Channel Access Token。
(2) 可直接以「文字輸入」模式填入，或以「選擇欄位」模式帶入表單中的欄位值。
2. 收訊人：
(1) 請填入收訊人的 LINE user ID。請注意：這和 LINE 個人檔案中顯示的 ID 並不相同。LINE User ID 通常為 U 開頭、共 33 碼的英數混合字串，例如：U8189cf6745fc0d808977bdb0b9f22995。
(2) 可直接以「文字輸入」模式填入，或以「選擇欄位」模式帶入表單中的一個或多個欄位值。
3. 訊息格式：
(1) 可以選擇純文字格式或圖文排版格式（ Flex Message）。
純文字格式
圖文排版格式（Flex Message）
(2) 若選圖文排版格式（Flex Message），需要在內文區塊撰寫 JSON（可在登入 LINE 帳號後，用 LINE 官方提供的 Flex Message Simulator 設定排版後，產生對應 JSON ）。
4. 訊息推播標題（altText）：
(1) 訊息格式選擇圖文排版格式（Flex Message）時才需要填寫，傳送 LINE 訊息時，收訊人 LINE 推播通知、對話列表預覽畫面會顯示此段文字。收訊人 LINE App 無法顯示圖文畫面時，也會以這裡設定的文字替代。
(2) 可直接以「文字輸入」模式填入，或以「選擇欄位」模式帶入表單中的欄位值。
5. 內文：在此自訂要傳送的訊息內容，並可搭配參數使用。支援參數請參考這裡。
1. 只能透過 LINE 官方帳號傳送訊息給追蹤該帳號的使用者，不支援從私人 LINE 帳號傳送。
2. 傳送訊息前必須知道追蹤者的 LINE User ID。以下幾點請注意：
(1) 使用者無法自行查詢 LINE User ID，必須透過官方帳號使用 LINE Messaging API 才能取得。
(2) 建議具備程式能力的使用者可透過 API 取得；不熟悉程式的使用者則可參考我們的 Make 串接教學。
(3) 同一位使用者在不同的官方帳號可能會有不同的 LINE User ID，因此若同時管理多個官方帳號，跨帳號直接複製 User ID 可能無法使用。
(4) 不支援傳送附件、使用 HTML 語法、顯示子表格欄位。
除了即時傳送LINE 訊息按鈕外，Ragic 還提供另外兩種透過 LINE 傳送訊息的功能：用 LINE 分享這筆資料與傳送系統通知至 LINE。請參考下表以了解差異。
| 功能 | 發訊方 | 收訊方 | 傳送內容 | 設定人 | 限制 |
|---|---|---|---|---|---|
| 即時傳送LINE 訊息 | 用戶的 LINE 官方帳號 | 官方帳號的追蹤者 | 可以彈性自訂客製化訊息 | 限 SYSAdmin | 請參考這裡 |
| 用 LINE 分享這筆資料 | 個人 LINE 帳號 | 自行選擇對象 | 傳送資料連結 | 使用者 | 只能分享單筆資料 |
| 傳送系統通知至 LINE | 雲端版：Ragic 官方 LINE 帳號
私有主機版：用戶的 LINE 官方帳號 |
使用者個人帳號 | 系統通知內容，請參考此章節 | 使用者 | 內容不可自訂，雲端版僅開放給專業版以上用戶 |
在進階設定中可以勾選儲存時自動執行。預設只有第一次新增時自動執行傳送訊息，若希望每次儲存資料（包括新增及修改資料）都自動傳送訊息的話，可以取消勾選此設定。
注意：每張表單只能有一個儲存自動執行的按鈕。
在進階設定中可以設定是否顯示執行成功時的提示訊息，若取消勾選（不顯示執行成功訊息），執行時間較長時，較難掌握是否及何時執行成功，因此建議保留此項勾選。
另外也可以勾選自訂執行成功時的提示訊息，下方會出現訊息輸入欄位可以輸入自訂的提示訊息，請留意字數限制。
關於移除動作按鈕可以參考這篇。
或是要針對動作按鈕做附加設定的話，例如限制使用使用動作按鈕的權限等，可以參考這篇說明。
| 參數 | 說明 |
|---|---|
| {{SERVER_DOMAIN_NAME}} | 伺服器名稱與埠號 |
| {{AP_NAME}} | 帳號名稱 |
| {{SHEET_NAME}} | 表單名稱 |
| {{TITLE_FIELD}} | 標題欄位的名稱 |
| {{RECORD_ID}} | 該筆資料的 ID |
| {{RECORD_LINK}} | 該筆資料的連結（透過三竹傳送的台灣號碼不支援） |
| {{TITLE_VALUE}} | 標題欄位的值 |
| {{欄位ID}} | 該欄位的值，不支援子表格欄位 |
| {{欄位名稱}} | 該欄位的值，不支援子表格欄位，若有重複欄位名稱請使用 {{欄位ID}} |
| {{USERNAME_使用者欄位ID}} | 使用者欄位若用 {{欄位ID}} 會顯示 Email，若要顯示使用者名稱可用此變數。不支援子表格欄位 |
| {{USERNAME_使用者欄位名稱}} | 同上，使用欄位名稱而非欄位 ID。不支援子表格欄位 |
| {{GROUPUSERS_群組欄位ID}} | 群組欄位若用 {{欄位ID}} 會顯示群組名稱，若要顯示群組成員 Email 可用此變數。不支援子表格欄位 |
| {{GROUPUSERS_群組欄位名稱}} | 同上，使用欄位名稱而非欄位 ID。不支援子表格欄位 |
| {{RAWURL_URL欄位ID}} | 網址欄位若用 {{欄位ID}} 會顯示超連結，若要顯示純文字網址可用此變數。不支援子表格欄位 |
| {{RAWURL_URL欄位名稱}} | 同上，使用欄位名稱而非欄位 ID。不支援子表格欄位 |
| {{MAGIC_RECORD_LINK_READONLY}} | 資料的 magic link（唯讀） |
| {{MAGIC_RECORD_LINK_WRITABLE}} | 資料的 magic link（可修改） |
感謝您的寶貴意見！
