Можно ли не использовать webhook, а просто опрашивать API?

Да, полностью. GET /v1/numbers/{id}/messages вернёт до 50 последних сообщений. Укажите параметр since_iso чтобы получить только новые. Большинство агентов опрашивают API каждые 2-3 секунды во время ожидания кода.

Могу ли я получать SMS со скоротелефонов (5-значные коды)?

Да, полностью. Верификационные SMS от банков, крипто-бирж, приложений для знакомств — все приходят от скоротелефонов. Это одна из главных причин, почему VoIP не работает, а реальные номера операторов работают идеально.

Какие сервисы поддерживают верификацию через SMS API?

Наша система работает с любыми сервисами, отправляющими SMS: Cash App, Coinbase, Stripe, PayPal, Wise, Revolut, Apple Pay, Google Pay, Zelle, Tinder, Bumble, Match, Instagram, TikTok, Discord, WhatsApp Business, Telegram, Xiaohongshu, Amazon, eBay, Etsy, Shopify, Uber, DoorDash, Netflix, Hulu, Disney+, Peacock, и многие другие.

Как настроить безопасность webhook и проверить подпись?

Каждый POST к вашему webhook подписан заголовком X-MeiSIM-Signature с HMAC-SHA256. Проверьте подпись, используя ваш API secret, чтобы убедиться, что запрос действительно пришёл от нас.

Что делать если webhook был недоступен?

SMS сохраняется на нашем сервере 30 дней. Если webhook был недоступен, вы сможете получить все пропущенные сообщения через GET /v1/numbers/{id}/messages с параметром since.

Как долго хранятся SMS сообщения?

Все SMS хранятся на наших серверах в течение 30 дней. За этот период вы можете извлечь любое сообщение через polling API, даже если webhook был недоступен.

Поддерживаете ли вы MMS (сообщения с изображениями)?

Сейчас только SMS. MMS находится в разработке и будет добавлен в ближайшие месяцы.

Какая задержка при polling каждые 2-3 секунды?

При polling каждые 2-3 секунды риск пропустить код минимален, так как верификационные SMS обычно приходят в течение 30 секунд. На случай сбоя есть 30-дневное хранилище для повторных запросов.

Можно ли использовать одно число для многих агентов?

Технически да, но не рекомендуется. Каждый агент должен использовать свой собственный номер, чтобы избежать конфликтов при одновременных верификациях и для правильного логирования.

Как извлечь OTP код из SMS автоматически?

Используйте регулярное выражение вроде /\b\d{4,8}\b/ для базовых случаев. Для большей надёжности передайте текст SMS в Claude или GPT-4o — они извлекут код за миллисекунды с высокой точностью.

Работает ли это с номерами из Китая, России, ЕС?

Да, SMS API работает с номерами в разных странах. Вы получаете реальные номера от местных операторов связи, которые успешно проходят верификацию в международных сервисах.

Какой минимальный период polling рекомендуется?

Оптимально опрашивать API каждые 2-3 секунды при ожидании верификационного кода. Это обеспечит быстрое обнаружение при минимальной нагрузке на API.

Можно ли получить исторические SMS после провайдера?

Да, все SMS хранятся 30 дней. Вы можете запросить сообщения за любой период внутри этого срока через GET запрос с параметром since_iso.

Гайд · SMS API

SMS API для чатботов и AI-агентов

TL;DR

Ваш AI-агент или чатбот нуждается в американском номере, который может получать SMS коды верификации из Cash App, Coinbase, Stripe, PayPal, банковских приложений или любого двухфакторного потока. Twilio блокирует большинство из них как VoIP.

Получите API ключ

5 бесплатных номеров. Доставка webhook менее 3 секунд.

Смотреть API →

Общий процесс

Ваш агент вызывает POST /v1/numbers/provision с URL вашего webhook.
Примерно через 60 секунд агент получает реальный US номер (eSIM QR, ICCID и LPA возвращаются в ответе).
Агент использует этот номер для регистрации на Cash App, Coinbase, PayPal или любом другом сервисе.
Сервис верификации отправляет SMS код на наш номер.
MeiSIM получает SMS от оператора связи (~1 секунда).
MeiSIM отправляет сообщение на ваш webhook URL (~1-2 секунды).
Ваш агент читает JSON, извлекает код, завершает регистрацию.

Контракт webhook

Мы отправляем JSON на ваш URL. Вы должны вернуть HTTP 200 в течение 10 секунд для подтверждения. Если вы не ответили или произошла ошибка, мы повторяем попытку с экспоненциальной задержкой (сразу, +15с, +60с, +300с — всего 4 попытки за 6 минут). Сообщения также доступны через endpoint сообщений в течение 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" }

Fallback режим polling

Если вы предпочитаете опрашивать API вместо того, чтобы поддерживать webhook (частое решение для stateless агентов), вызовите:

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

Большинство агентов опрашивают API каждые 2-3 секунды во время ожидания верификационного кода. Обычно коды приходят в течение 30 секунд; при ошибке повтор может занять до 5 минут.

Извлечение OTP кода

Текст SMS различается по сервисам, но код всегда содержит 4-8 цифр. Большинство агентов используют регулярное выражение вроде /\b\d{4,8}\b/ для простых случаев. Для большей надёжности попросите LLM (Claude или GPT-4o) прочитать текст и вернуть только код — это займёт миллисекунды с высокой точностью.

Аутентификация и безопасность

Каждый webhook POST подписан HMAC-SHA256. Проверьте заголовок X-MeiSIM-Signature, используя ваш API secret, чтобы убедиться, что запрос действительно пришёл от нас, а не от злоумышленника. Примеры кода в документации API.

Разработайте сегодня

Бесплатный API ключ + первые 5 номеров. Напишите нам и мы вас настроим.

Написать →

Частые вопросы

Как быстро SMS приходит на webhook?

Медианная задержка менее 3 секунд. При ошибке webhook повторяем с экспоненциальной задержкой. Все сообщения хранятся 30 дней для режима polling.

Можно ли просто опрашивать API вместо webhook?

Да. GET /v1/numbers/{id}/messages с опциональным since=ISO. Большинство агентов опрашивают каждые 2-3с во время ожидания верификации.

Могу ли я получать SMS со скоротелефонов (5-значные)?

Да — это главная причина переходить на реальные номера операторов. Большинство банковских, крипто и dating-app верификаций приходят со скоротелефонов, которые VoIP блокирует.

Что насчёт MMS (с изображениями)?

Только SMS пока. MMS в дорожной карте.

Поддерживаете ли вы несколько webhook'ов на один номер?

Один webhook на номер. Для fan-out маршрутизируйте через собственный диспетчер.

Как проверить подпись webhook?

Используйте ваш API secret для проверки HMAC-SHA256 из заголовка X-MeiSIM-Signature. Примеры кода в API документации.

Что если webhook был недоступен?

SMS сохраняется 30 дней. Получите пропущенные сообщения через GET /v1/numbers/{id}/messages с параметром since.

Сколько лет номеры?

Все номера реальные и активные. Они не удаляются после получения одного SMS — вы можете использовать одно число столько раз, сколько нужно.

Работает ли с Coinbase, PayPal, Wise?

Да, работает со всеми основными финсервисами: Coinbase, Kraken, Binance.US, PayPal, Wise, Revolut, Stripe, Square и сотнями других.

Может ли агент использовать одно число для разных верификаций?

Да, одно число может получать SMS от разных сервисов. Просто следите, какой код для какого сервиса, если одновременно приходит несколько.