웹훅을 사용하지 않고 폴링만 할 수 있습니까?

네, 가능합니다. GET /v1/numbers/{id}/messages는 최대 50개의 최근 메시지를 반환합니다. since_iso를 설정하면 특정 시간 이후의 메시지만 조회할 수 있습니다. 대부분의 에이전트는 검증 대기 중에 2-3초마다 폴링합니다.

단문 코드(5자리 번호)에서 SMS를 받을 수 있습니까?

네, 받을 수 있습니다. 미국 은행, 데이팅 앱, 암호화폐 거래소 및 대부분의 앱에서 전송되는 검증 SMS는 단문 코드를 통해 전달됩니다. 이것이 VoIP가 실패하고 실제 통신사 번호가 성공하는 주요 이유입니다.

가이드 · SMS API

챗봇 및 AI 에이전트용 SMS API

핵심 요약

AI 에이전트가 Cash App, Coinbase, Tinder, 은행 앱, 암호화폐 거래소 또는 다른 서비스의 SMS 검증 코드를 받을 수 있는 전화번호가 필요하신가요? Twilio 같은 VoIP는 대부분 거부됩니다. MeiSIM의 웹훅 API를 통해 실제 미국 통신사 번호에서 SMS를 수신하여 챗봇이나 AI 에이전트를 연결하는 방법을 알려드립니다.

API 키 받기

무료 번호 5개. 웹훅 전달 시간 3초 이내.

API 보기 →

전체 흐름 요약

에이전트가 웹훅 URL과 함께 POST /v1/numbers/provision을 호출합니다.
약 60초 후 실제 미국 전화번호를 받습니다 (응답에 eSIM QR, ICCID, LPA 포함).
에이전트가 그 번호로 Cash App / Coinbase 등에 가입합니다.
가입 서비스가 해당 번호로 검증 SMS를 전송합니다.
MeiSIM이 통신사 네트워크를 통해 SMS를 수신합니다 (약 1초).
MeiSIM이 웹훅 URL로 메시지를 전송합니다 (약 1-2초 추가).
에이전트가 본문을 읽어 코드를 추출하고 가입을 완료합니다.

웹훅 계약

우리는 JSON 본문을 URL로 전송합니다. 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" }

폴링 대체 방식

웹훅 엔드포인트를 유지하지 않고 폴링을 선호하는 경우 (상태 비저장 에이전트에서 흔함), 다음을 호출하세요:

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는 밀리초 단위로 처리합니다.

인증 및 보안

모든 웹훅 POST는 HMAC-SHA256으로 서명됩니다. API 시크릿으로 X-MeiSIM-Signature를 검증하여 요청이 실제로 우리에게서 온 것인지, 사기자에게서 온 것이 아닌지 확인하세요. 코드 샘플은 API 문서를 참고하세요.

오늘 밤 구축하세요

API 키 + 처음 5개 번호 무료. 문의하시면 바로 설정해드립니다.

이메일 →

자주 묻는 질문

SMS가 웹훅에 도착하는데 얼마나 걸립니까?

중앙값은 3초 미만입니다. 실패 시 지수 백오프로 재시도합니다. 메시지는 30일 동안 저장되므로 폴링 대체 방식으로 조회할 수 있습니다.

웹훅 대신 폴링만 할 수 있습니까?

네. GET /v1/numbers/{id}/messages를 사용하면 되고, 선택적으로 since=ISO를 추가할 수 있습니다. 대부분의 에이전트는 검증 대기 중에 2-3초마다 폴링합니다.

단문 코드(5자리)에서 SMS를 받을 수 있습니까?

네 — VoIP에서 실제 통신사 번호로 전환하는 주요 이유입니다. 대부분의 은행/암호화폐/데이팅 앱 검증 SMS는 단문 코드에서 전송되는데, VoIP는 이를 차단합니다.

MMS(이미지 포함)도 지원합니까?

현재는 SMS만 지원합니다. MMS는 로드맵에 있습니다.

번호당 여러 웹훅을 지원합니까?

번호당 웹훅 1개입니다. 팬아웃이 필요하면 자신의 디스패처를 통해 라우팅하세요.

Cash App 검증을 위한 미국 번호는 어떻게 얻습니까?

MeiSIM USA의 SMS API를 통해 실제 미국 통신사 번호를 할당받을 수 있습니다. 번호는 60초 이내에 발급되며, Cash App 인증 SMS를 즉시 수신할 수 있습니다.

Coinbase 인증을 위해 프로그래밍 방식으로 번호를 자동 할당할 수 있습니까?

네, 완전히 가능합니다. POST /v1/numbers/provision을 호출하면 자동으로 새 번호가 할당되고, Coinbase KYC 인증을 위해 바로 사용할 수 있습니다.

Tinder 검증 SMS의 도착 시간은?

대부분의 Tinder 검증 SMS는 30초 이내에 도착합니다. MeiSIM의 웹훅은 SMS 수신 후 평균 2-3초 내에 전달됩니다.

한국에서 미국 SMS API를 사용할 수 있습니까?

네, 완전히 가능합니다. 한국에서 API 키를 발급받아 미국 번호를 할당받고, 웹훅을 통해 SMS를 수신할 수 있습니다. 지연 시간은 지역과 무관하게 3초 미만입니다.

OTP 코드 추출을 자동으로 할 수 있습니까?

네, 정규식(/\b\d{4,8}\b/)을 사용하거나 Claude/GPT-4o 같은 LLM에 SMS 본문을 읽게 하여 코드만 반환하게 할 수 있습니다. 대부분의 경우 밀리초 단위로 처리됩니다.

웹훅 서명 검증은 어떻게 합니까?

모든 웹훅 POST는 HMAC-SHA256으로 서명됩니다. X-MeiSIM-Signature 헤더를 API 시크릿으로 검증하여 요청이 실제로 MeiSIM에서 온 것인지 확인하세요. API 문서에서 코드 샘플을 확인할 수 있습니다.

은행 앱 2FA 검증을 위해 실제 번호가 필요한 이유는?

VoIP 번호는 대부분의 은행과 금융 서비스에서 차단됩니다. 실제 미국 통신사 번호를 사용해야 은행 2FA 검증 SMS를 수신할 수 있습니다.

여러 개의 미국 번호를 동시에 할당받을 수 있습니까?

네, 필요한 만큼 번호를 할당받을 수 있습니다. 각 번호는 독립적인 웹훅을 가질 수 있으며, 모두 동시에 SMS를 수신할 수 있습니다.

국제 전화번호는 지원합니까?

현재는 미국(+1) 번호만 지원합니다. 미국 기반 서비스와 앱의 검증에는 미국 번호가 필수입니다.

실패한 웹훅 요청을 어떻게 재시도합니까?

웹훅 실패 시 지수 백오프로 재시도합니다: 즉시, +15초, +60초, +300초로 총 4회 시도합니다. 모든 메시지는 30일 동안 저장되므로 폴링으로 조회할 수도 있습니다.

SMS API의 가격은?

처음 5개 번호는 무료입니다. 추가 번호와 요금은 상담을 통해 확인할 수 있습니다. support@meisimusa.com으로 문의하세요.