Czy muszę używać webhooków? Czy mogę tylko pollować?

Tak, możesz. GET /v1/numbers/{id}/messages zwraca do 50 ostatnich wiadomości. Ustaw parametr since_iso, aby otrzymać tylko wiadomości po określonym czasie. Większość agentów polluje co 2-3 sekundy podczas czekania na weryfikację.

Czy mogę odbierać SMS z shortcode'ów (5-cyfrowe numery)?

Tak. SMS weryfikacyjne z banków USA, aplikacji randkowych, giełd kryptowaluty i większości aplikacji wysyłane przez shortcode'y docierają normalnie. To jeden z głównych powodów, dla których VoIP zawodzi i rzeczywiste numery operatorów odnoszą sukces.

Czy mogę mieć wiele webhooków dla jednego numeru?

Jeden webhook na numer. Jeśli potrzebujesz fan-out, możesz routować przez własny dispatcher.

Jakie są limity na liczbę numerów?

Nie ma sztywnych limitów. Możesz zacząć z 5 bezpłatnych numerów. W miarę potrzeb możesz zwiększać plan.

Czy obsługujecie długie kody SMS (short codes)?

Tak, obsługujemy short code'y (5-7 cyfrowe numery), które są używane przez większość usług weryfikacji, banków i platform społecznych.

Czy SMS jest bezpieczne? Jak weryfikujecie webhookami?

Każdy webhook jest podpisany przy użyciu HMAC-SHA256. Weryfikuj nagłówek X-MeiSIM-Signature, aby potwierdzić, że żądanie pochodzi od nas, a nie od atakującego.

Czy mogę używać własnego numeru lub eSIM?

Nasze API pracuje z rzeczywistymi numerami z sieci operatorów (AT&T, T-Mobile itp.) dostarczonymi jako eSIM. Nie możesz używać własnego numeru w API.

Czy numeracja US będzie działać za granicą?

Tak, numeracja US będzie działać dla weryfikacji wszędzie na świecie. SMS z serwisów globalnych będzie docierać normalnie niezależnie od lokalizacji agenta.

Czy mogę odbierać SMS ze zmiennych wysyłających?

Tak. Możesz odbierać SMS ze zmiennych numerów wysyłających (od osób, short code'ów, usług), ich numery będą widoczne w polu 'from' w webhookami lub odpowiedzi API.

Ile czasu trwa provisioning nowego numeru?

Typowo około 60 sekund od żądania POST /v1/numbers/provision do otrzymania numeru i QR kodu eSIM.

Czy wspieracie Voice Over IP (VoIP)?

Nie, nasze numery to rzeczywiste numery operatorów, nie VoIP. To pozwala nam odbierać SMS ze short code'ów i weryfikacyjne kody, które VoIP blokuje.

Czy mogę integrować SMS API z ChatGPT lub Claude?

Tak, możesz używać funkcji Claude lub GPT-4o do parsowania tekstu SMS i ekstrakcji kodów OTP. Polecamy to dla wyższej niezawodności niż regex.

Jakie są koszty po wyjściu poza plan bezpłatny?

Cennik zależy od liczby numerów i wiadomości. Patrz stronę /plans.html dla szczegółów. Zazwyczaj zaczynamy od kilku dolarów za numer miesięcznie.

Przewodnik · SMS API

SMS API dla chatbotów i agentów AI

TL;DR

Twój agent AI potrzebuje numeru telefonu, który może odbierać SMS weryfikacyjne z Cash App, Coinbase, Tinder, aplikacji bankowych lub dowolnego przepływu 2FA. Twilio odrzuca większość z nich jako VoIP. Tutaj dowiesz się, jak połączyć chatbota lub agenta, aby odbierać rzeczywiste SMS przez webhook API MeiSIM.

Uzyskaj klucz API

5 bezpłatnych numerów. Dostarczenie webhookiem poniżej 3 sekund.

Sprawdź API →

Przebieg procesu w pigułce

Twój agent wywołuje POST /v1/numbers/provision z adresem webhookami.
Po około 60 sekundach agent ma rzeczywisty numer telefonu US (QR kod eSIM + ICCID + LPA zwrócone w odpowiedzi).
Agent używa numeru do rejestracji na Cash App / Coinbase / itp.
Usługa rejestracyjna wysyła SMS weryfikacyjne do numeru.
MeiSIM otrzymuje SMS przez sieć operatora (~1s).
MeiSIM POST-uje wiadomość do adresu webhookami (~1-2s więcej).
Twój agent odczytuje treść, ekstrahuje kod, dokańcza rejestrację.

Specyfikacja webhookami

Wysyłamy JSON-a do Twojego adresu URL. Zwracasz HTTP 200 w ciągu 10 sekund w odpowiedzi. Jeśli zawiedsz lub upłynie timeout, ponawiamy z backoffem (natychmiast, +15s, +60s, +300s — razem 4 próby przez 6 minut). Wiadomości można również wysyłać zapytań za pośrednictwem endpoint'u wiadomości przez 30 dni.

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 z pollowaniem

Jeśli wolisz pollować zamiast utrzymywać endpoint webhookami (typowe dla bezstanowych agentów), wywołaj:

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

Większość agentów polluje co 2-3 sekundy podczas czekania na weryfikację. SMS weryfikacyjne zwykle docierają w ciągu 30 sekund; nieudane próby mogą trwać do 5 minut przed ponowieniem.

Ekstrakcja kodu OTP

Treść SMS różni się w zależności od usługi, ale kod to zawsze liczba 4-8 cyfrowa. Większość agentów używa regex'u takiego jak /\b\d{4,8}\b/ do ekstrakcji. Aby uzyskać wyższą niezawodność, niech LLM przeczyta tekst i zwróci sam kod — Claude lub GPT-4o radzą sobie z tym w milisekundach.

Uwierzytelnianie i bezpieczeństwo

Każdy POST webhookami jest podpisany HMAC-SHA256. Zweryfikuj X-MeiSIM-Signature przy użyciu tajnego klucza API, aby potwierdzić, że żądanie faktycznie pochodzi od nas, a nie od podszywacza. Przykład kodu w dokumentacji API.

Zacznij dzisiaj wieczorem

Klucz API + pierwsze 5 numerów gratis. Wyślij nam e-mail, a ustawimy Cię.

E-mail →

Często zadawane pytania

Jak szybko SMS dociera do mego webhookami?

Medianowe opóźnienie poniżej 3 sekund. Ponawianie przy awarii z backoffem eksponencjalnym. Wiadomości przechowywane 30 dni dla fallbacku pollowania.

Czy mogę po prostu pollować zamiast webhookami?

Tak. GET /v1/numbers/{id}/messages, opcjonalnie z since=ISO. Większość agentów polluje co 2-3s podczas czekania na weryfikację.

Czy mogę odbierać SMS z shortcode'ów (5-cyfrowe)?

Tak — to główny powód, aby przejść na rzeczywiste numery operatorów. Większość SMS weryfikacyjnych z banków/kryptogirażów/aplikacji randkowych pochodzi z shortcode'ów, a VoIP je blokuje.

A co z MMS (wiadomości z obrazkami)?

Na razie tylko SMS. MMS jest na mapie drogowej.

Czy obsługujecie wiele webhooków na numer?

Jeden webhook na numer. W celu fan-out routuj przez własny dispatcher.

Czy mogę odbierać SMS niezależnie od kraju wysyłającego?

Tak, numery US będą odbierać SMS ze wszystkich krajów. SMS z międzynarodowych serwisów będzie docierać normalnie.

Czy webhook musi być publicznie dostępny?

Tak, nasz system musi móc wysłać POST-a do Twojego webhookami, więc musi być dostępny z internetu (chyba że używasz tunelu takiego jak ngrok).

Czy wspieracie Slack/Discord integracje?

Nie bezpośrednio, ale możesz skonfigurować webhookami do wysłania danych do Slack lub Discord webhook'a jako część logiki przetwarzania.

Czy mogę filtrować SMS po numerze wysyłającego?

API zwraca pole 'from', więc możesz filtrować w logice aplikacji. Nie obsługujemy filtrów na poziomie API.

Czy SMS będzie działać dla 2FA i kodów weryfikacyjnych?

Tak, główny przypadek użycia to właśnie odbieranie kodów OTP i SMS weryfikacyjnych z aplikacji i usług.

Czy mogę używać tych numerów do wysyłania SMS?

Nie, te numery są tylko do odbierania. Aby wysyłać SMS, potrzebujesz innego serwisu.

Czy mogę mieć stały numer przez wiele dni?

Liczby są przydzielane dynamicznie. Dla stałych numerów zaplanuj retention w ramach płatnego planu.

Czy API ma ratelimit?

Tak, szczegóły w dokumentacji API. Bezpłatny plan ma rozsądne limity; płatne plany są bardziej hojna.

Czy mogę zintegrować to z Python, Node.js, Java?

Tak, API to standardowy REST JSON. Możemy dostarczyć SDK lub biblioteki dla popularnych języków.