簡訊 API · Taiwan SMS API

台灣簡訊 API:一支 REST API 發驗證碼、通知與大量簡訊

MAAC Go SMS 是漸強實驗室(Crescendo Lab)的自助簡訊服務。線上註冊就能拿 API key,NT$0.78/則起、沒有月費,送達狀態用 Webhook 回傳,送出前自動做 NCC 合規檢查。

POST /api/sms/send
curl -X POST https://sms.cresclab.com/api/sms/send \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to":"0912345678",
       "body":"【你的品牌】驗證碼 483291,5 分鐘內有效",
       "type":"otp"}'

# 回應
{"ok":true,"message_id":"sms_abc123","status":"sent",
 "segments":1,"cost_cents":78,"balance_cents":4922}

規格一覽

想比較簡訊 API 時最常問的幾件事。

價格
NT$0.78/則起(中文 70 字為 1 則、英數 160 字為 1 則;超過會分段計費)
月費/綁約
沒有月費、沒有綁約;預付儲值,最低 NT$100
試用
註冊並驗證手機後送 30 則試用簡訊(可先發到自己的手機測試)
送達門號
中華電信、遠傳、台灣大哥大門號都能送
送達回報
Webhook(HMAC-SHA256 簽章)回傳 delivered/failed;也可用 API 查單則狀態
狀態
queued → sent → delivered;失敗為 failed,收件人退訂為 stop
NCC 合規
送出前自動檢查:需有【品牌】簽名、行銷簡訊需含退訂(STOP/退訂),不合規直接擋下並告訴你原因
國際簡訊
可發 18 個國家/地區(英、新、港、中、日、韓、馬、泰、越、菲、印尼、澳、紐、德、法、荷、西、義),依目的地計價
SDK 與規格
Node(@maacgo/sms)、Python(maacgo-sms)、CLI(maacgo);完整 OpenAPI 規格
AI Agent
官方 MCP server(npm @maacgo/mcp),Claude、Cursor、Codex 等可直接發簡訊

API 能做什麼

所有呼叫都用 Authorization: Bearer sk_live_...。路徑、欄位與錯誤碼見 API 文件 與 OpenAPI 規格。

發一則簡訊

驗證碼、訂單/出貨通知、預約提醒。type 可設 otp/notification/marketing。

大量發送(1 對多)

一次發給名單,可排程。30 人以內即時發送,超過自動分批。

查狀態與紀錄

查單則狀態、發送紀錄列表、近 N 天統計(送達率、花費)。

送達回報 Webhook

設定一個網址,送達或失敗即時通知,HMAC-SHA256 簽章驗證來源。

餘額與交易紀錄

查錢包餘額與扣款紀錄;餘額不足時 API 回 402 並附儲值連結。

合規檢查

不合規的內容回 ncc_blocked 並列出原因,改好再送。

從註冊到正式發送

  1. 註冊並驗證手機 — 拿到 API key 與 30 則試用簡訊,可以先發到自己的手機測試。
  2. 完成身分驗證(線上上傳) — 審核約 1–2 個工作天。個人身分每天最多 50 則、內容不能帶連結;公司身分(公司登記+負責人證件)為一般額度。
  3. 儲值後正式發送 — 最低 NT$100,按則扣款;用 API、後台或 AI Agent 發都共用同一個錢包。

讓 AI 幫你串

不想自己寫程式?把 llms-full.txt 或 OpenAPI 網址貼給 Claude、Cursor、ChatGPT 產生串接程式;或直接裝官方 MCP server,讓 AI Agent 自己發簡訊——見 AI 發簡訊。

常見問題

簡訊 API 怎麼計費?

按則計費,NT$0.78/則起。中文 70 字(英數 160 字)算 1 則,超過會分段,每段各算 1 則。沒有月費、沒有綁約,預付儲值、最低 NT$100。

註冊後多久可以發給客戶?

註冊並驗證手機後馬上能拿 API key,用 30 則試用簡訊發到自己的手機測試。要發給客戶,需先在後台完成身分驗證,審核約 1–2 個工作天;個人身分每天最多 50 則且不能帶連結,公司身分為一般額度。

怎麼知道簡訊有沒有送達?

設定 Webhook 網址後,送達(sms.delivered)或失敗(sms.failed)會即時通知,並以 HMAC-SHA256 簽章。也可以用 API 查單則狀態:queued → sent → delivered。

可以發國際簡訊嗎?

可以,目前開放 18 個國家/地區(英國、新加坡、香港、中國、日本、韓國、馬來西亞、泰國、越南、菲律賓、印尼、澳洲、紐西蘭、德國、法國、荷蘭、西班牙、義大利),依目的地計價。

可以用 Zapier、Make 或 n8n 串嗎?

可以,用它們的 HTTP 模組直接呼叫 REST API(帶 Bearer API key)。目前沒有專屬的連接器。

內容會被擋嗎?什麼是 NCC 合規檢查?

送出前系統會自動檢查:需要有【品牌】簽名,行銷簡訊需要附退訂方式(STOP/退訂)。不合規的內容會被擋下(ncc_blocked)並告訴你原因,改好再送就好。

最後更新:2026-10-26。價格與規則以 sms.cresclab.com 公告為準。