sms_marketing.config.get
read讀取 SMS 營銷設定，包括 Sender ID、gateway、短網址、退訂、排程、審批、配額、成本及 tracking 政策。
建議先讀取
無需前置工具。
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續寫入必須以系統設定為準；不得自行假設 Sender ID、gateway、退訂或成本規則。
SMS 營銷系統 MCP 工具
本頁列出 SMS 營銷系統規劃中的 MCP 工具，涵蓋 Sender ID、SMS gateway、發送配額、frequency cap、客戶分眾、電話與同意紀錄、退訂名單、短訊範本、70 字內容預覽、短網址、成本預覽、活動草稿、排程發送、行為觸發、OTP、送達狀態、重發、點擊與轉化追蹤。
sms_marketing.sender_ids.list
read列出已登記或待審 Sender ID、SSRS 狀態、可用地區、品牌名稱及限制。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
未驗證或地區不適用的 Sender ID 不得用於正式發送。
sms_marketing.gateways.list
read列出可用 SMS gateway、覆蓋國家、費率、送達回報能力、速率限制及 fallback 設定。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
發送前必須確認目標地區、費率和 delivery report 支援；不得用錯 gateway。
sms_marketing.approval_policies.list
read列出建立活動、更新退訂、排程、正式發送、重發、Sender ID 申請及 OTP 發送的審批條件。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
任何觸發政策的寫入必須建立 action request 或保持草稿；不得直接外發。
sms_marketing.quotas.get
read讀取 SMS 餘額、每月配額、國家費率、分段計費、速率限制及預估可發送量。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
建立排程或發送前必須檢查餘額；不得建立會超額或超成本的批次。
sms_marketing.frequency_caps.get
read讀取每位客戶每日、每週、每活動及交易類 SMS 的頻率限制。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
SMS 成本和打擾度高；正式發送必須套用 frequency cap。
sms_marketing.owners.list
read列出市場推廣、CRM、營運、合規、技術和審批負責人與權限。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
不得把發送、重發、OTP 或 Sender ID 申請分派給無權限帳戶。
sms_marketing.audiences.list
read列出 SMS 名單、來源、同意狀態、可發送電話數、購買行為、地區及同步來源。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
只回傳有權查看的名單；無同意或受限制電話不得暴露。
sms_marketing.segments.preview
preview預覽 SMS 分眾的人數、退訂、重複電話、國家費率、frequency cap 排除及預估成本。
建議先讀取
sms_marketing.audiences.list、sms_marketing.opt_outs.list、sms_marketing.quotas.get
治理與審批
預覽工具；不會寫入資料。
安全說明
預覽必須列出排除原因；不得把退訂、無同意、重複或超頻客戶加入分眾。
sms_marketing.segments.create
write按已預覽條件建立 SMS 分眾，例如指定客群、訂單狀態、付款、取貨、優惠或再購買週期。
建議先讀取
sms_marketing.segments.preview
治理與審批
寫入工具；大型或高成本分眾建議審批。
安全說明
必須使用 segment_preview_id；不得擴大收件範圍或忽略 frequency cap。
sms_marketing.contacts.search
read按電話、客戶、名單、標籤、訂單狀態、同意、退訂或發送歷史搜尋聯絡人。
建議先讀取
sms_marketing.audiences.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
搜尋結果應最小化個人資料；電話號碼可按權限遮罩。
sms_marketing.contacts.get
read讀取單一聯絡人的電話、同意證據、退訂、語言、地區、發送歷史及版本資料。
建議先讀取
sms_marketing.contacts.search 或已知 contact_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續更新必須使用回傳 contact_id 及 base_version_token，避免覆蓋較新退訂狀態。
sms_marketing.contacts.upsert
write建立或更新聯絡人電話、國家碼、標籤、語言、同意證據、來源及 CRM 同步鍵。
建議先讀取
sms_marketing.contacts.get 或 sms_marketing.contacts.search
治理與審批
寫入工具；大量匯入、改同意或跨系統同步建議審批。
安全說明
不得新增無同意證據的可發送電話；必須保留資料來源和時間。
sms_marketing.opt_outs.list
read查詢退訂、STOP、封鎖、無效電話、投訴及不可發送電話名單。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
退訂名單是發送前硬限制；任何活動或 OTP 以外流程不得覆蓋。
sms_marketing.contacts.opt_out
write把電話號碼設為退訂，記錄來源、STOP 訊息、時間、原因、語言及同步狀態。
建議先讀取
sms_marketing.contacts.get
治理與審批
合規寫入；使用者 STOP 或退訂通常應即時執行，不需審批延遲。
安全說明
不得移除退訂證據或延遲 suppression；退訂必須立即阻止後續推廣 SMS。
sms_marketing.templates.list
read列出短訊範本、語言、動態欄位、用途、字數、退訂文字及審批狀態。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
活動內容應使用合適範本，並保留必要退訂或品牌識別文字。
sms_marketing.templates.save
write儲存可重用短訊範本，包括動態欄位、語言、用途、退訂提示和字數限制。
建議先讀取
sms_marketing.templates.list、sms_marketing.approval_policies.list
治理與審批
寫入工具；正式品牌、OTP 或合規字句改動建議審批。
安全說明
不得移除品牌識別、退訂提示或必要合規內容；必須保存版本。
sms_marketing.copy.fit_preview
preview預覽短訊文案是否符合中文 70 字、英文 160 字、Unicode 分段、變數替換和多 SMS 成本。
建議先讀取
sms_marketing.templates.list、sms_marketing.quotas.get
治理與審批
預覽工具；不會寫入資料。
安全說明
預覽必須顯示最長變數情境、分段數、成本及可能被截斷內容。
sms_marketing.short_links.preview
preview預覽長 URL 轉短網址後的字數、domain、UTM、到期日、點擊 tracking 及黑名單風險。
建議先讀取
sms_marketing.config.get、sms_marketing.copy.fit_preview
治理與審批
預覽工具；不會寫入資料。
安全說明
不得使用可疑 domain、錯誤 UTM、無效到期日或未授權 tracking。
sms_marketing.short_links.create
write建立已預覽短網址，保存原 URL、UTM、到期日、活動、點擊 tracking 和擁有人。
建議先讀取
sms_marketing.short_links.preview
治理與審批
寫入工具；涉及敏感落地頁、金融支付或大量活動建議審批。
安全說明
必須使用 short_link_preview_id；不得把短連結指向未批准或不一致頁面。
sms_marketing.campaigns.list
read列出 SMS 活動草稿、分眾、短訊、短連結、排程、發送、審批及報告狀態。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
只顯示使用者有權查看的活動；未公開優惠或名單不得外洩。
sms_marketing.campaigns.get
read讀取單一活動的短訊、分眾、短連結、成本預覽、Sender ID、gateway、排程、審核及版本資料。
建議先讀取
sms_marketing.campaigns.list 或已知 campaign_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續更新、排程或發送必須使用回傳 campaign_id 及 base_version_token。
sms_marketing.campaigns.create_draft
write建立 SMS 活動草稿，包含分眾、短訊、短網址、Sender ID、gateway、追蹤及發送目標。
建議先讀取
sms_marketing.segments.preview、sms_marketing.copy.fit_preview、sms_marketing.short_links.preview
治理與審批
寫入工具；建立草稿通常可直接執行，正式發送需按政策。
安全說明
不得建立無同意分眾、無退訂處理、字數超額、成本不明或 Sender ID 不可用的活動。
sms_marketing.campaigns.update
write更新短訊內容、分眾、短網址、Sender ID、gateway、tracking、排程草稿或審核備註。
建議先讀取
sms_marketing.campaigns.get、sms_marketing.approval_policies.list
治理與審批
寫入工具；已批准、已排程或高成本活動改動建議審批。
安全說明
只更新明確指定欄位；不得覆蓋審核、退訂或版本資料。
sms_marketing.cost_preview
preview預覽活動按國家、字數分段、gateway、短連結、frequency cap 及退訂排除後的實際成本。
建議先讀取
sms_marketing.campaigns.get、sms_marketing.quotas.get、sms_marketing.gateways.list
治理與審批
預覽工具；不會寫入資料。
安全說明
預覽必須標明不可發送數、超額、估算費率和實際扣費可能差異。
sms_marketing.campaigns.schedule
write為已準備活動設定發送時間、時區、分批節奏、gateway、frequency cap 及通知。
建議先讀取
sms_marketing.campaigns.get、sms_marketing.cost_preview、sms_marketing.sender_ids.list
治理與審批
寫入工具；正式排程需按審批政策或明確確認。
安全說明
不得排程未審核、超成本、無有效 Sender ID、無退訂或含無同意分眾的活動。
sms_marketing.campaigns.cancel_schedule
write取消尚未發送的 SMS 排程，記錄原因、負責人、影響人數及通知狀態。
建議先讀取
sms_marketing.campaigns.get
治理與審批
寫入工具；臨近發送或大型活動取消可要求審批。
安全說明
不得取消已開始發送批次；已發送內容需用後續通知或停止剩餘批次處理。
sms_marketing.campaigns.send_approved
write正式發送已批准 SMS 活動，套用退訂、配額、成本、Sender ID、gateway、短連結及 frequency cap。
建議先讀取
sms_marketing.campaigns.get、sms_marketing.opt_outs.list、sms_marketing.cost_preview
治理與審批
高風險外發寫入；必須有審批或明確確認。
安全說明
不得發送未批准、退訂、無同意、超成本、Sender ID 無效、字數錯誤或 landing page 不一致的活動。
sms_marketing.automations.list
read列出訂單、付款、出貨、預約提醒、取貨、再購買及行為觸發 SMS 流程。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
流程必須顯示觸發事件、頻率限制、退訂處理、template 版本及最後更新時間。
sms_marketing.automations.update_state
write啟用、暫停或更新指定 SMS 觸發流程的事件、範本、頻率、退訂排除和 gateway。
建議先讀取
sms_marketing.automations.list、sms_marketing.approval_policies.list
治理與審批
寫入工具；大量、促銷或交易關鍵流程啟用建議審批。
安全說明
不得啟用缺少退訂處理、頻率限制、有效範本或成本檢查的流程。
sms_marketing.otp_templates.list
read列出 OTP/2FA 範本、用途、有效時間、限速、gateway、地區及審批狀態。
建議先讀取
sms_marketing.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
OTP 範本不得包含推廣內容；必須符合限速和安全要求。
sms_marketing.otp.send
write按已批准 OTP 範本發送驗證碼或 2FA SMS，並記錄限速、送達和安全審計資料。
建議先讀取
sms_marketing.otp_templates.list、sms_marketing.gateways.list
治理與審批
安全寫入；通常由交易流程觸發，異常或大量發送需按政策。
安全說明
不得把 OTP 工具用作推廣；必須套用限速、防濫用及最小內容原則。
sms_marketing.send_batches.list
read查詢 SMS 發送批次、gateway 回應、送達、失敗、pending、扣費及錯誤摘要。
建議先讀取
sms_marketing.campaigns.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
送達狀態必須標明 gateway、更新時間和狀態定義；pending 不等於成功。
sms_marketing.delivery_status.get
read讀取單一訊息或電話的送達、失敗原因、扣費、gateway message id 及重發資格。
建議先讀取
sms_marketing.send_batches.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
個人層級狀態應按權限遮罩電話；不得暴露不必要個資。
sms_marketing.failed_messages.retry_preview
preview預覽重發失敗 SMS 的合資格數量、排除原因、成本、頻率限制、退訂狀態及預期成效。
建議先讀取
sms_marketing.delivery_status.get、sms_marketing.opt_outs.list、sms_marketing.quotas.get
治理與審批
預覽工具；不會寫入資料。
安全說明
預覽必須排除退訂、已送達、硬失敗、無效電話和超頻客戶。
sms_marketing.failed_messages.resend
write按預覽結果重發合資格失敗 SMS，保留 gateway、扣費、原因和重發批次紀錄。
建議先讀取
sms_marketing.failed_messages.retry_preview
治理與審批
寫入工具；大量、促銷或高成本重發建議審批。
安全說明
必須使用 retry_preview_id；不得重發給退訂、已送達或不可發送電話。
sms_marketing.campaign_reports.get
read讀取活動送達、失敗、點擊、退訂、成本、轉化、收入及時間趨勢。
建議先讀取
sms_marketing.campaigns.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
報告必須標明日期範圍、gateway、歸因窗口、成本規則及資料延遲。
sms_marketing.link_clicks.list
read列出短網址點擊、唯一點擊、UTM、裝置、時間、分眾及後續轉化摘要。
建議先讀取
sms_marketing.campaign_reports.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
個人層級點擊應按權限最小化；不得暴露完整電話或敏感行為。
sms_marketing.conversion_attribution.get
read讀取 SMS 帶來的訂單、預約、付款、收入、ROI、轉化路徑及歸因規則。
建議先讀取
sms_marketing.campaign_reports.get、sms_marketing.link_clicks.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
轉化歸因必須標明 attribution window、渠道衝突、退款扣除和追蹤限制。
sms_marketing.performance_snapshot.record
write記錄人工或外部來源取得的送達、點擊、成本、退訂、轉化、收入或 gateway 成效快照。
建議先讀取
sms_marketing.campaign_reports.get、sms_marketing.conversion_attribution.get
治理與審批
寫入工具；通常可直接記錄，覆蓋既有結果時需審批。
安全說明
必須保存來源、日期範圍、gateway、歸因設定和證據；不得偽造成效。
sms_marketing.review_notification.send
write通知負責人處理活動審核、發送確認、成本異常、退訂上升、送達失敗或 ROI 問題。
建議先讀取
sms_marketing.owners.list、sms_marketing.campaigns.get 或 sms_marketing.campaign_reports.get
治理與審批
通知寫入；一般可直接執行，外部或大量通知需按政策。
安全說明
不得通知無關人員或包含完整電話名單；通知應只包含必要摘要。
sms_marketing.sender_id.apply
write提交或更新 Sender ID / SSRS 申請資料，包括品牌名稱、公司資料、用途、地區和證明文件狀態。
建議先讀取
sms_marketing.sender_ids.list、sms_marketing.approval_policies.list
治理與審批
高風險設定寫入；建議建立審批請求。
安全說明
不得提交不真實品牌或未授權公司資料；必須保存申請原因、文件和版本。
sms_marketing.action_request.status
status查詢 SMS 寫入、排程、發送、重發、OTP、Sender ID、tracking 或通知操作的狀態。
建議先讀取
已知 action_request_id
治理與審批
狀態查詢工具；不會建立新的審批請求。
安全說明
狀態結果只代表治理流程進度；不得重試非冪等外發動作，除非使用相同 idempotency_key 或明確新請求。