convez.ai
MCP ServerIntegração & APIsIntermediário
agentsimdev

AgentSIM Python SDK

agentsimdev/agentsim-python

Números de telefone reais para agentes IA receberem OTP automaticamente

Ver no GitHub
InicialPluginScore · de 0 a 100

SDK 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-python

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
2

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

ExceptionWhen
AuthenticationErrorMissing or invalid API key
PoolExhaustedErrorNo numbers available in requested country
OtpTimeoutErrorNo OTP arrived within timeout seconds
RateLimitErrorToo many requests — back off and retry
SessionNotFoundErrorSession expired or already released
CountryNotAllowedErrorCountry not available on current plan

Supported Countries

US

Ver o original no GitHub

Bom para

Relacionados