Tôi có thể chỉ polling thay vì dùng webhook không?

Có. GET /v1/numbers/{id}/messages trả về tối đa 50 tin nhắn gần đây. Đặt since_iso để chỉ lấy tin nhắn sau một timestamp nhất định. Hầu hết các agent polling mỗi 2-3 giây khi chờ xác minh.

Tôi có thể nhận SMS từ short code (số 5 chữ số) không?

Có. SMS xác minh từ các ngân hàng Mỹ, ứng dụng hẹn hò, sàn giao dịch crypto, và hầu hết các ứng dụng gửi qua short code đều nhận bình thường. Đây là lý do chính khiến VoIP thất bại và số điện thoại thực của mạng lưới thành công.

API SMS webhook có an toàn không?

Có, mỗi webhook POST được ký bằng HMAC-SHA256. Bạn nên xác minh header X-MeiSIM-Signature bằng API secret của mình để đảm bảo yêu cầu thực sự từ MeiSIM, không phải từ kẻ giả mạo.

SMS có thể đến từ đâu?

SMS có thể đến từ short code (ví dụ: 245-78 cho Cash App), long code (số điện thoại thông thường), hoặc sender ID. Hầu hết xác minh 2FA sử dụng short code vì vậy nhận từ short code là rất quan trọng.

MMS (tin nhắn có hình ảnh) có được hỗ trợ không?

Hiện tại chỉ hỗ trợ SMS văn bản. MMS có trong lộ trình phát triển cho những tháng tới.

Tôi có thể có nhiều webhook cho một số không?

Một webhook cho một số. Nếu cần fan-out, hãy định tuyến qua dispatcher riêng của bạn.

Tôi phải làm gì nếu webhook của tôi bị ngừng hoạt động?

Không vấn đề gì. SMS được lưu trữ trong 30 ngày, bạn có thể lấy lại bằng GET /v1/numbers/{id}/messages với tham số since để lấy tất cả tin nhắn từ lần cuối cùng bạn kiểm tra.

Latency tối thiểu là bao lâu?

Latency tối thiểu về mặt lý thuyết là ~1 giây (mạng lưới nhà mạng) + ~1-2 giây (xử lý MeiSIM) = ~2-3 giây. Chúng tôi thường thấy dưới 3 giây ở phần trăm thứ 50.

Tôi có thể sử dụng API SMS cho nhiều quốc gia không?

API này cung cấp số điện thoại Mỹ. Để nhận SMS từ quốc gia khác, bạn cần số từ quốc gia đó. MeiSIM USA hiện tập trung vào các số Mỹ.

Giá cả như thế nào?

5 số đầu tiên miễn phí. Sau đó, giá bắt đầu từ $15-25/tháng tùy theo gói. Liên hệ với chúng tôi để biết thêm chi tiết về mức giá cho khối lượng lớn.

Có thể sử dụng cho chatbot không?

Hoàn toàn có thể. Đây là trường hợp sử dụng chính của chúng tôi. Chatbot có thể cấp phát số, đợi SMS, trích xuất mã, và hoàn tất xác minh tất cả lập trình.

Có thể sử dụng cho tự động hóa không?

Có, API được thiết kế để tự động hóa. Bạn có thể tự động hóa toàn bộ quy trình cấp phát số → xác minh 2FA → hoàn tất tài khoản mà không cần can thiệp thủ công.

Hướng dẫn · API SMS

SMS API cho chatbot và AI agent

TL;DR

AI agent của bạn cần một số điện thoại có thể nhận mã xác minh SMS từ Cash App, Coinbase, Tinder, ứng dụng ngân hàng, hoặc bất kỳ luồng xác minh 2FA nào. Twilio từ chối hầu hết chúng vì là VoIP. Dưới đây là cách kết nối chatbot hoặc agent của bạn để nhận SMS thực tế qua API webhook của MeiSIM.

Nhận API key

5 số miễn phí. Webhook delivery trong <3 giây.

Xem API →

Quy trình tổng quát

Agent của bạn gọi POST /v1/numbers/provision với URL webhook.
Khoảng 60 giây sau, agent của bạn có số điện thoại thực tế Mỹ (QR code eSIM + ICCID + LPA được trả về).
Agent sử dụng số để đăng ký trên Cash App / Coinbase / vv.
Dịch vụ đăng ký gửi SMS xác minh đến số đó.
MeiSIM nhận SMS qua mạng lưới nhà mạng (~1 giây).
MeiSIM POST tin nhắn đến URL webhook của bạn (~1-2 giây nữa).
Agent của bạn đọc nội dung, trích xuất mã, hoàn tất đăng ký.

Webhook contract

Chúng tôi POST một phần thân JSON đến URL của bạn. Bạn trả về HTTP 200 trong vòng 10 giây để xác nhận. Nếu bạn thất bại hoặc hết thời gian chờ, chúng tôi thử lại với backoff (ngay lập tức, +15s, +60s, +300s — tổng cộng 4 lần thử trong 6 phút). Tin nhắn cũng có thể truy vấn qua endpoint messages trong 30 ngày.

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" }

Fallback polling

Nếu bạn thích polling hơn là duy trì endpoint webhook (phổ biến cho agent stateless), hãy gọi:

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": "..." }, ...] }

Hầu hết các agent polling mỗi 2-3 giây khi chờ xác minh. SMS xác minh thường đến trong vòng 30 giây; các lần thử thất bại mất tới 5 phút trước khi thử lại.

Trích xuất mã OTP

Nội dung SMS thay đổi theo dịch vụ nhưng mã luôn là số 4-8 chữ số. Hầu hết các agent sử dụng regex như /\b\d{4,8}\b/ để trích xuất. Để độ tin cậy cao hơn, hãy cho LLM đọc văn bản và chỉ trả về mã — Claude hoặc GPT-4o xử lý điều này trong vài mili giây.

Xác thực và bảo mật

Mỗi webhook POST được ký bằng HMAC-SHA256. Xác minh X-MeiSIM-Signature bằng API secret của bạn để xác nhận yêu cầu thực sự từ chúng tôi, không phải từ kẻ giả mạo. Mẫu mã trong API docs.

Xây dựng tối nay

API key + 5 số đầu tiên miễn phí. Email cho chúng tôi và chúng tôi sẽ thiết lập cho bạn.

Gửi email →

Câu hỏi thường gặp

SMS đến webhook của tôi nhanh như thế nào?

Thời gian trễ trung bình <3 giây. Tự động thử lại khi thất bại với backoff mũ. Tin nhắn được lưu 30 ngày cho fallback polling.

Tôi có thể chỉ polling thay vì webhook không?

Có. GET /v1/numbers/{id}/messages, tùy chọn có since=ISO. Hầu hết agent polling mỗi 2-3s khi chờ xác minh.

Tôi có thể nhận từ short code (5 chữ số) không?

Có — đó là lý do chính để chuyển sang số điện thoại thực của mạng lưới. Hầu hết SMS xác minh từ ngân hàng/crypto/ứng dụng hẹn hò đến từ short code, và VoIP chặn chúng.

Còn MMS (có hình ảnh) thì sao?

Chỉ SMS hiện tại. MMS có trong lộ trình phát triển.

Bạn có hỗ trợ nhiều webhook cho mỗi số không?

Một webhook mỗi số. Để fan-out, hãy định tuyến qua dispatcher riêng của bạn.

API SMS có an toàn để sử dụng cho các ứng dụng nhạy cảm không?

Có. Mỗi yêu cầu webhook được ký bằng HMAC-SHA256 và bạn nên xác minh chữ ký trước khi xử lý dữ liệu. Tất cả truyền thông đều qua HTTPS.

Latency thấp nhất là bao lâu?

Latency tối thiểu là ~1 giây (mạng nhà mạng) + ~1-2 giây (xử lý) = ~2-3 giây. Chúng tôi thường thấy dưới 3 giây ở p50.

Có giới hạn tỷ lệ SMS không?

Không có giới hạn cứng. Nếu bạn có lưu lượng truy cập lớn, hãy liên hệ hỗ trợ để thảo luận về cấu hình.

Những ứng dụng nào có thể xác minh bằng API SMS này?

Hầu hết ứng dụng Mỹ: Cash App, Coinbase, Stripe, PayPal, Tinder, Bumble, Discord, WhatsApp Business, Telegram, Instagram, TikTok, Amazon seller, eBay, Uber, Lyft, DoorDash, ngân hàng Mỹ, và nhiều ứng dụng khác.

Tôi có thể sử dụng cho nhiều quốc gia không?

API này cung cấp số Mỹ. Nếu cần số từ quốc gia khác, bạn cần dùng nhà cung cấp của quốc gia đó. MeiSIM USA tập trung vào số Mỹ.

Giá cả là bao nhiêu?

5 số đầu tiên miễn phí. Sau đó từ $15-25/tháng tùy gói. Liên hệ chúng tôi để biết giá khối lượng lớn.

Webhook có thể được dùng cho fan-out không?

Một webhook được gọi mỗi lần. Nếu cần gửi đến nhiều endpoint, bạn cần có dispatcher riêng để xử lý fan-out từ webhook chính.