```html SMS API для чатботів та AI агентів — отримання верифікації на реальні США номери
Посібник · SMS API

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

TL;DR

Ваш AI агент або чатбот потребує номера телефону, що може отримувати SMS коди верифікації з Cash App, Coinbase, Tinder, PayPal, банківських додатків, Stripe, Amazon та будь-якого 2FA потоку. Twilio блокує більшість як VoIP.

Ваш AI агент або чатбот потребує номера телефону, що може отримувати SMS коди верифікації з Cash App, Coinbase, Tinder, PayPal, банківських додатків, Stripe, Amazon та будь-якого 2FA потоку. Twilio блокує більшість як VoIP. Ось як підключити чатбот або агента для отримання реальних SMS через webhook API MeiSIM — затримка менше 3 секунд, реальні номери операторів США, підтримка коротких кодів, безплатний старт.

Отримайте API ключ

5 дарункових номерів. Webhook доставка менше 3 секунд.

Подивитись API →

Принцип роботи в скорочені

  1. Ваш агент викликає POST /v1/numbers/provision з webhook URL.
  2. ~60 секунд пізніше, агент отримує реальний США номер (eSIM QR, ICCID, LPA повертаються в відповіді).
  3. Агент використовує номер для реєстрації на Cash App, Coinbase, Tinder, PayPal, Stripe, Amazon, eBay, або іншому сервісі.
  4. Сервіс реєстрації надсилає верифікаційну SMS на номер.
  5. MeiSIM отримує SMS через мережу оператора (~1 секунда).
  6. MeiSIM відправляє повідомлення на ваш webhook URL (~1-2 секунди більше).
  7. Ваш агент читає текст, витягує код, завершує реєстрацію.

Контракт 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" }

Резервне опитування

Якщо вам більше подобається опитування замість утримання webhook endpoint (звичайна практика для 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 секунди під час очікування верифікації. SMS верифікація зазвичай приходить за 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 секунд. Повтор при невдачі з експоненціальною затримкою. Повідомлення зберігаються 30 днів для резервного polling.

Чи можу я просто опитувати API замість webhook?

Так. GET /v1/numbers/{id}/messages, опціонально з since=ISO. Більшість агентів опитує кожні 2-3с під час очікування верифікації.

Чи можна отримувати SMS з коротких кодів (5-цифрові)?

Так — це основна причина переходу на реальні номери операторів. Більшість SMS верифікації від банків/крипто/додатків знайомств приходять з коротких кодів, а VoIP їх блокує.

Як щодо MMS (з зображеннями)?

SMS тільки поки що. MMS в планах розвитку.

Чи підтримуєте кілька webhook на номер?

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

Які сервіси підтримують SMS верифікацію?

Майже всі: Cash App, PayPal, Coinbase, Kraken, Stripe, Tinder, Bumble, Instagram, TikTok, Amazon, eBay, Uber, DoorDash, Lyft, Discord, Telegram, WhatsApp, Revolut, Wise, Chime, Mercury, Apple Pay, Google Pay та США банки.

Чи працюють ваші номери для міжнародних додатків?

Так, реальні США номери розпізнаються як легітимні для більшості міжнародних сервісів. Деякі китайські додатки можуть мати обмеження — зв'яжіться з нами.

Яка вартість?

API безплатна, перші 5 номерів дарункові. Кожен додатковий номер $5-15/місяць. SMS прийом включений.

Скільки часу займає отримання номера?

Зазвичай 60 секунд. Ви отримаєте eSIM QR, ICCID, LPA в відповіді POST.

Чи працюють на iPhone та Android?

Так, всі пристрої — iPhone (iOS 16+), Android, планшети, навіть деякі смартгодинники. Активація через QR код.

Як безпечність?

Кожен webhook підписаний HMAC-SHA256. Перевірте X-MeiSIM-Signature з вашим API secret.

Чи можна орендувати номер на кілька днів?

Мінімум 1 місяць звичайно, але є спеціальні плани для коротких проектів. Зв'яжіться з нами.

Чи блокуються номери як спам?

Дуже рідко — реальні номери операторів, не VoIP. Якщо позначений, ми замінимо.

Чи працює для бізнес верифікації на Stripe або PayPal?

Так, повна підтримка Stripe Atlas, PayPal, Amazon seller, eBay seller, Shopify та інших платформ.

Яка мінімальна активність для утримання номера?

Номер залишається ваш поки ви його утримуєте. Зв'яжіться якщо потрібна допомога.

```