AgentSIM Python SDK
agentsimdev/agentsim-python
Números de telefone reais para agentes IA receberem OTP automaticamente
Ver no GitHubSDK Python para provisionar números de telefone reais com SIM integrada, permitindo que agentes IA recebam e processem códigos OTP autonomamente. Elimina a necessidade de intermediários humanos em fluxos de verificação por SMS.
Instalação
npx convez-ai agentsimdev/agentsim-python1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de verificação por SMS em fluxos de checkout
- Testes automatizados de serviços que exigem autenticação por OTP
- Agentes IA que precisam completar cadastros com validação por telefone
Veredito

Ferramenta muito específica e de alto valor para automação de fluxos que exigem OTP. Solução pragmática que resolve um problema real de agentes IA, mas com suporte limitado (apenas EUA no momento) e requer conta paga.
README
A tradução para o português deste README ainda está na fila.
agentsim-sdk
Autonomous OTP relay for AI agents. AgentSIM provisions real carrier-routed phone numbers, receives inbound SMS, and delivers parsed OTP codes back to your agent — no human relay needed.
Install
uv add agentsim-sdk
Or with pip:
pip install agentsim-sdk
Quickstart
import agentsim
async with agentsim.provision(agent_id="checkout-bot", country="US") as num:
await enter_phone_number(num.number) # "+14155552671"
otp = await num.wait_for_otp(timeout=60)
await enter_otp(otp.otp_code) # "391847"
# number auto-released
Auth
Set AGENTSIM_API_KEY in your environment, or call agentsim.configure() at startup:
agentsim.configure(api_key="asm_live_xxx")
Get your API key at console.agentsim.dev.
API
agentsim.provision(*, agent_id, country="US", service_url=None, ttl_seconds=3600, webhook_url=None)
Returns an async context manager. Provisions a number on enter, auto-releases on exit (even if the body raises).
async with agentsim.provision(agent_id="stripe-setup", country="US") as num:
print(num.number) # E.164 phone number
print(num.session_id)
otp = await num.wait_for_otp(timeout=30)
print(otp.otp_code)
num.wait_for_otp(timeout=60, auto_reroute=False, max_reroutes=2, on_reregistration_needed=None)
Long-polls until an OTP arrives or timeout seconds elapse.
Returns: OtpResult(otp_code, from_number, received_at)
Raises: OtpTimeoutError if no OTP arrives within timeout seconds.
Set auto_reroute=True to automatically provision a replacement number in another country if no OTP arrives. on_reregistration_needed is an async callback (new_number: str, country: str) -> None called when re-registration on the target service is required.
agentsim.provision_sync(...) / num.wait_for_otp_sync(timeout=60)
Synchronous variants for non-async codebases:
with agentsim.provision_sync(agent_id="x") as num:
otp = num.wait_for_otp_sync(timeout=60)
Error Reference
| Exception | When |
|---|---|
AuthenticationError | Missing or invalid API key |
PoolExhaustedError | No numbers available in requested country |
OtpTimeoutError | No OTP arrived within timeout seconds |
RateLimitError | Too many requests — back off and retry |
SessionNotFoundError | Session expired or already released |
CountryNotAllowedError | Country not available on current plan |
Supported Countries
US