Utilizar o seu proxy

SMS / códigos de verificação

Um telefone que tenha emparelhado pode encaminhar os SMS que o seu SIM recebe — códigos de verificação únicos (OTP), mais utilmente — para a sua conta. Leia-os no dashboard ou através da API, por dispositivo.

Para que serve isto

Iniciar sessão numa conta a partir de um IP móvel desencadeia muitas vezes um código de verificação SMS enviado para o número desse telefone. Se o telefone for um que possui e tenha emparelhado, a app consegue capturar essas mensagens de entrada e mostrá-las — para que possa ler o código sem ter o dispositivo fisicamente na mão. É esse o uso previsto: OTP em telefones que possui.

Opcional, e desligado a menos que o permita

A captura de SMS depende de uma permissão opcional (RECEIVE_SMS). O proxy funciona plenamente sem ela. Se recusar o pedido no telefone, nada é capturado e a lista fica vazia — tudo o resto continua a funcionar.

Como funciona

Quando um SMS chega ao telefone, a app lê-o (juntando as partes de uma mensagem multipartes numa só), coloca-o em fila no dispositivo e encaminha o lote em fila para a sua conta pela mesma ligação móvel que o telefone já usa para falar com o plano de controlo. O encaminhamento acontece no ciclo de poll normal do telefone (~25 s), por isso um código aparece poucos segundos depois de chegar. Se o telefone estiver momentaneamente offline, as mensagens ficam em buffer no dispositivo e são enviadas assim que voltar. Cada mensagem guardada mantém o remetente, o corpo e a hora de receção.

Apenas por sideload

O Google Play restringe as permissões de SMS, por isso esta funcionalidade só existe no APK instalado por sideload. Veja Transferir para saber porque a app é instalada por sideload e o que captura.

Lê-los no dashboard

Cada cartão de dispositivo tem um painel recolhível SMS recebidos. Abra-o e lista as mensagens do mais recente para o mais antigo — remetente, data/hora e corpo completo — e atualiza-se sozinho a cada ~15 segundos enquanto estiver aberto, para que um código que chegue a meio de um registo apareça sem recarregar a página. Um selo de contagem mostra quantas mensagens estão no dispositivo. Se o telefone nunca recebeu a permissão de SMS, o painel simplesmente indica que ainda não há mensagens.

Lê-los através da API

As mesmas mensagens estão disponíveis por dispositivo. A lista vai do mais recente para o mais antigo e está limitada às 200 mais recentes.

curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/sms \
     -H "Authorization: Bearer mpx_live_…"

# → {
#     "subscription_id": "sub_760c1fc8ddab",
#     "messages": [
#       { "id": "1042",
#         "sender": "+15550101",
#         "body": "Your verification code is 314159",
#         "received_at": "2026-07-05T14:12:00.000Z" }
#     ]
#   }

Cada mensagem traz um id, o sender (o endereço de origem, que pode ser null para alguns remetentes de código curto), o body da mensagem e received_at. O endpoint devolve um array messages vazio — nunca um erro — quando o telefone não encaminhou nada, incluindo quando a permissão de SMS foi recusada.

Dica

Autentique-se com um token de API de utilizador (mpx_live_…) da mesma forma que no resto da API, ou leia a partir da sessão do dashboard. O dispositivo tem de pertencer à sua conta ou obterá um 404.

Os detalhes campo a campo estão na consola de API interativa, a par do resto de Estado e utilização.