功能介紹｜簡訊+ API - 整合 LINE + 簡訊自動化發送機制

功能介紹

簡訊+ API 提供品牌一個整合訊息推送的解決方案。透過串接單一 API，品牌可依據用戶電話號碼，自動選擇最適合的通訊頻道發送訊息，並支援活動成效（Event ID）紀錄，協助品牌：

• 以最低成本觸及用戶

• 簡化發送機制與開發成本

• 建立跨渠道的行銷成效分析基礎

• 對推播結果進行事件歸因與自動化流程延伸

此功能特別適用於：

• 需要計算跨渠道訊息投報率（ROI）的行銷活動

• 需要整合 CRM/預約系統欄位進行訊息紀錄查詢的品牌

• 未加入 LINE OA 的潛在用戶邀請情境

頻道順序	說明
LINE 一般推播	僅限有加入品牌 LINE 好友，且在 MAAC 能以電話比對到【 LINE 單一聯絡人】
LINE 通知型訊息	用戶未封鎖品牌即可接收
簡訊	若 LINE 一般推播 & LINE 通知型訊息發送失敗，可使用簡訊發送

🧾 通知型訊息詳細規則，請參考：幫助中心｜功能介紹｜LINE 通知型訊息說明

---

設定教學

Step 1：功能開通

請聯繫您的 CSM 開通以下權限：

• 簡訊+ API 功能

• 通知型訊息發送權限（如需使用）
  詳細說明：常見問題｜通知型訊息申請流程

Step 2：取得發送 Token

1. 向 MAAC 取得 OpenAPI Token，需包含 Notification messages 權限。

2. Token 取得後，即可串接簡訊+ API。

API 文件參考：
https://cresclab.docs.apiary.io/#reference/+/1/(push)

Step 3：API 串接與欄位說明

根據使用需求不同，SMS+ API 串接方式可分為以下兩種情境：

情境一：需要進行行銷成效追蹤（建議用於活動型訊息）

若品牌需要追蹤特定活動的訊息送達率與轉換效果（例如：註冊活動、會員招募、問卷邀請等），可透過 MAAC 提供的 event_id 功能，進行訊息歸因與報表追蹤。

串接流程如下：

1. 先建立訊息主題（Event）
   請透過 MAAC OpenAPI 建立此次活動的訊息主題，取得對應的 event_id
   API 文件：https://cresclab.docs.apiary.io/#reference/3/1/(push)

2. 呼叫 簡訊+ API 發送訊息
   在 簡訊+ API 發送內容中加入 event_id 欄位，系統會將此筆訊息歸因至該活動，後續可於 MAAC 後台查詢歸因結果。
   API 文件：https://cresclab.docs.apiary.io/#reference/+/1

3. 查詢成效報表
   可於 MAAC 後台中依據 活動名稱 檢視訊息送達狀況，作為活動成效分析依據。

報表支援以下功能：

• 查看同一個 活動名稱 下的所有訊息發送紀錄

• 檢視各訊息的發送狀態與送達狀況（依頻道類型區分，例如：LINE 推播、通知型訊息、簡訊）

• 彙總顯示各 活動名稱 對應的發送總量與成效結果

備註：活動清單排序規則
MAAC 後台的活動報表頁面，將依 event_id 建立時間排序，最新建立的活動會顯示在最上方。

注意事項：

• 活動名稱 最長可接受 100,000 字元

• 若呼叫 API 時未傳入 event_id，該訊息紀錄將視為未歸因訊息，會出現在成效報表中的【SMS+ API】活動中。

• 活動名稱（event_name）將自動彙整 所有透過該活動 ID 發送之範本訊息的數據，協助品牌完整掌握整體活動成效。

  您可透過頁面中的下拉選單，選擇任一活動名稱，進一步查看該活動下各個訊息範本的發送數據，包括：

  • 各範本的發送次數與成功率

  • 各訊息渠道（LINE 推播、LINE 通知型訊息、簡訊）的送達統計

情境二：不需追蹤成效，僅進行訊息發送

若品牌僅需使用簡訊+ API 進行單純訊息發送（例如：通知型訊息、帳單提醒、系統通知等），則可直接呼叫發送 API，無需建立訊息主題或指定 event_id。

串接流程如下：

1. 呼叫 簡訊+ API 發送訊息
   在 簡訊+ API 發送內容中加入指定範本 & 相關參數欄位。
   API 文件：https://cresclab.docs.apiary.io/#reference/+/1

此類發送將不進行活動歸因，但仍可透過 MAAC 後台查詢發送狀態與紀錄。

---

查詢發送結果

可透過後台查詢以下資料：

• 訊息發送紀錄與狀態

• 發送失敗原因（如：格式錯誤、未綁定 UID、簡訊包含敏感字詞等）

🔎 查詢方式請參考：
幫助中心｜查詢簡訊+ API 發送紀錄與狀態