如果我不想要 Webhook，可以只輪詢嗎？

可以。GET /v1/numbers/{id}/messages 返回最多 50 條最近訊息。設定 since_iso 以僅獲取時間戳後的訊息。大多數代理在等待驗證時每 2-3 秒輪詢一次。

我可以接收來自短代碼（5 位數字）的 SMS 嗎？

可以。來自美國銀行、約會應用程式、加密貨幣交易所和大多數應用程式的驗證 SMS 通過短代碼發送，正常送達。這是從 VoIP 切換到真實電信號碼的主要原因。

AI 聊天機器人為什麼需要真實美國號碼而不是 VoIP？

許多驗證服務（如 Cash App、Coinbase、Stripe、PayPal、Tinder）明確阻止 VoIP 號碼。真實電信號碼來自 AT&T、T-Mobile 和 Verizon 等實際運營商，因此被所有主要服務識別為合法。

可以在 AI 代理之間共享一個號碼嗎？

是的，一個號碼可以由多個代理共享。所有進入的 SMS 都會發送到同一 Webhook URL。為了區分來自不同服務的訊息，您可以在代理邏輯中使用發件人 ID（from 欄位）或時間戳。

如果我的 Webhook 端點宕機會怎樣？

MeiSIM 將使用指數退避重試 4 次（立即、15 秒、60 秒、300 秒）。訊息也存儲 30 天，因此您可以在恢復時通過 GET /v1/numbers/{id}/messages 端點輪詢它們。

OTP 代碼提取對不同服務有效嗎？

是的。大多數服務使用 4-8 位數字代碼。正則表達式 /\b\d{4,8}\b/ 適用於 Cash App、Coinbase、Stripe、PayPal 等。對於複雜格式，可以使用 Claude 或 GPT-4o 等 LLM 在幾毫秒內可靠地提取代碼。

MeiSIM 的 SMS API 支援哪些編程語言？

API 是 REST-based，因此適用於所有語言（Python、Node.js、Go、Java、Rust、C# 等）。SDK 可用於 Python 和 JavaScript；其他語言可以直接使用 HTTP 客戶端。

驗證 SMS 通常需要多長時間才能到達？

大多數驗證 SMS 在 10-30 秒內送達。失敗的嘗試或忙碌的線路可能需要 2-5 分鐘。使用輪詢或 Webhook 時，應實施 5 分鐘的超時。

SMS API 是否支援多語言訊息？

是的，SMS 以任何語言到達——包括中文、阿拉伯文、俄文等。Webhook 有效負載中的「text」欄位包含原始訊息。

現在支援 MMS 嗎？

目前僅支援 SMS（純文本）。MMS（帶圖像）在開發路線圖上。

免費試用包括哪些內容？

免費帳戶包括 5 個實時美國號碼、30 天訊息歷史記錄、無限 Webhook 重試和基本 API 支援。生產帳戶根據使用情況按月計費。

我可以為多個服務驗證保留一個號碼嗎？

可以。一個號碼可以用於多個帳戶和服務。確保您的代理正確解析每條訊息中的服務識別符（發件人 ID），以便路由到正確的帳戶建立流程。

指南 · SMS API

AI 聊天機器人和代理的 SMS API

TL;DR

您的 AI 代理需要一個可以接收來自 Cash App、Coinbase、Stripe、PayPal、Tinder、銀行應用程式或任何 2FA 流程的 SMS 驗證碼的電話號碼。Twilio 會拒絕其中大多數作為 VoIP。以下是如何將聊天機器人或代理連接到通過 MeiSIM Webhook API 接收真實 SMS 的方式。

取得 API 金鑰

5 個免費號碼。Webhook 傳遞在 <3 秒內。

查看 API →

流程概覽

您的代理呼叫 POST /v1/numbers/provision，提供 Webhook URL。
約 60 秒後，您的代理擁有一個真實的美國電話號碼（eSIM QR + ICCID + LPA 在響應中返回）。
代理使用該號碼在 Cash App / Coinbase / 等上註冊。
註冊服務向該號碼發送驗證 SMS。
MeiSIM 通過電信運營商網路接收 SMS（約 1 秒）。
MeiSIM 將訊息 POST 到您的 Webhook URL（再多約 1-2 秒）。
您的代理讀取正文，提取碼，完成註冊。

Webhook 合約

我們向您的 URL 發送 JSON 正文。您在 10 秒內返回 HTTP 200 以確認。如果您失敗或超時，我們會使用退避重試（立即、+15 秒、+60 秒、+300 秒——6 分鐘內共 4 次嘗試）。訊息也可通過訊息端點查詢 30 天。

POST https://your-agent.com/sms Content-Type: application/json X-MeiSIM-Signature: t=1716...,v1=hmac-sha256-of-body { "event": "sms.received", "number_id": "num_01HXY3...", "phone": "+14155551234", "from": "245-78", "text": "Your Cash App code is 583921. Don't share.", "received_at": "2026-05-19T14:23:01Z" }

輪詢備選方案

如果您更願意輪詢而不是維護 Webhook 端點（對無狀態代理很常見），請呼叫：

GET /v1/numbers/{id}/messages?since=2026-05-19T14:22:00Z Authorization: Bearer YOUR_API_KEY → { "messages": [{ "from": "245-78", "text": "Your Cash App code is 583921", "received_at": "..." }, ...] }

大多數代理在等待驗證時每 2-3 秒輪詢一次。驗證 SMS 通常在 30 秒內到達；失敗的嘗試在重試前可能需要長達 5 分鐘。

提取 OTP 碼

SMS 正文因服務而異，但碼始終是 4-8 位數字。大多數代理使用如 /\b\d{4,8}\b/ 的正則表達式來提取。為了更高的可靠性，讓 LLM 讀取文本並僅返回碼——Claude 或 GPT-4o 在幾毫秒內處理此問題。

身份驗證和安全性

每個 Webhook POST 都使用 HMAC-SHA256 簽名。使用您的 API 密鑰驗證 X-MeiSIM-Signature 來確認請求確實來自我們，而不是冒充者。代碼示例在 API 文件中。

今晚構建

API 金鑰 + 前 5 個號碼免費。給我們發送電子郵件，我們會為您設定。

發送電子郵件 →

常見問題

SMS 到達我的 Webhook 需要多快？

中位數 <3 秒。失敗時重試指數退避。訊息儲存 30 天以進行輪詢備選。

我可以只輪詢而不是 Webhook 嗎？

可以。GET /v1/numbers/{id}/messages，可選 since=ISO。大多數代理在驗證等待期間每 2-3 秒輪詢一次。

我可以接收來自短代碼（5 位數字）的訊息嗎？

可以——這是切換到真實電信號碼的主要原因。大多數銀行/加密貨幣/約會應用驗證 SMS 來自短代碼，VoIP 會阻止它們。

關於 MMS（帶圖像）？

目前僅限 SMS。MMS 在路線圖上。

您支援每個號碼多個 Webhook 嗎？

每個號碼一個 Webhook。對於扇出，通過您自己的調度程式進行路由。

為什麼 AI 代理應該使用 MeiSIM 而不是其他 SMS 服務？

MeiSIM 提供真實的電信號碼（不是 VoIP），<3 秒 Webhook 延遲，30 天訊息歷史記錄，以及對 Cash App、Stripe、Coinbase 和 Tinder 等所有主要驗證服務的支援。

我可以在多個代理之間共享一個號碼嗎？

可以。一個號碼可以為多個代理提供服務，所有進入的 SMS 都發送到同一 Webhook。在代理邏輯中使用「from」欄位來區分訊息。

Webhook 簽名驗證如何工作？

每個 POST 包含 X-MeiSIM-Signature 標頭。使用您的 API 密鑰和 HMAC-SHA256 來驗證簽名，以確認請求來自 MeiSIM。

如果我的 Webhook 端點宕機怎麼辦？

MeiSIM 使用指數退避重試 4 次。訊息還儲存 30 天，因此您可以通過輪詢端點在恢復時取回它們。

OTP 提取對不同服務有效嗎？

是的。正則表達式 /\b\d{4,8}\b/ 適用於 Cash App、Coinbase、Stripe、PayPal 等。對於複雜格式，使用 Claude 或 GPT-4o。

我需要為每個代理實例使用不同的號碼嗎？

不需要。一個號碼可以為多個實例提供服務。您還可以為不同的服務或區域配置多個號碼。

MeiSIM 支援哪些編程語言？

API 是 REST-based，適用於所有語言。Python 和 JavaScript SDK 可用。

驗證 SMS 通常需要多長時間？

大多數在 10-30 秒內。失敗的嘗試可能需要 2-5 分鐘。實施 5 分鐘超時。

SMS API 支援多語言訊息嗎？

是的，任何語言都可以——包括中文、阿拉伯文、俄文等。

一個號碼最多可以接收多少條 SMS？

沒有每日限制。實際限制由驗證服務施加。

免費試用包括什麼？

5 個實時美國號碼、30 天訊息歷史記錄、無限 Webhook 重試、基本 API 支援。