Ir para o conteúdo
Localtonet Localtonet Painel

Bot de SMS

Ajuda com esta página
Nesta página 7 seções
  1. Como funciona
  2. Antes de começar
  3. Configure o app de SMS
  4. Baixe e instale
  5. Conceda as permissões
  6. Entre com o token
  7. Faça login no bot do Telegram
  8. Abra o bot
  9. Envie /login com a sua chave de API
  10. Comandos
  11. Exemplos
  12. Solução de problemas
  13. Páginas relacionadas

O app Localtonet SMS transforma um celular Android em um endpoint de SMS: ele informa os SMS recebidos, envia SMS e disca códigos USSD. Você o controla pelo Telegram, com o bot de SMS do Localtonet, ou pelo painel.

Como funciona #

  • O app Localtonet SMS roda no celular Android e entra com um AuthToken.
  • O bot de SMS do Localtonet é um bot do Telegram. Depois que você faz login com a sua chave de API, ele envia os SMS que chegam aos seus celulares e aceita comandos para eles.
  • O painel também pode enviar SMS e executar códigos USSD: na aba SMS de um dispositivo no Gerenciador de proxies e em Configurações de SMS de um token em Meus tokens.

Antes de começar #

  • Um celular Android com um chip SIM. O app de SMS foi feito para Android 5.0 e posterior.
  • Um AuthToken para esse celular. Se o app Localtonet já roda no celular, use o mesmo token: o painel conecta o app de SMS a um dispositivo pelo token dele.
  • A sua chave de API. Ela aparece no Painel, em Chave de API.
  • Uma conta do Telegram, para usar o bot.

Configure o app de SMS #

  1. Baixe e instale #

    Baixe o app de SMS para Android em localtonet.com/download/localtonet-smsapp.zip. O mesmo link está por trás de Baixar app de SMS na aba SMS de um dispositivo no Gerenciador de proxies. Extraia o arquivo e instale o app no celular. O Android primeiro pede que você permita instalar apps desta origem.

  2. Conceda as permissões #

    Abra Localtonet Sms. O app pede as permissões de que precisa para funcionar:

    PermissãoNecessária para
    Enviar SMSEnviar mensagens pelo chip SIM do celular.
    Ler SMS, receber SMSLer a caixa de entrada e informar as mensagens recebidas.
    Chamadas telefônicasExecutar códigos USSD. O app os disca.
    CâmeraLer o código QR de um token.
    NotificaçõesMostrar a notificação do app enquanto ele está em execução.
  3. Entre com o token #

    Digite ou cole o token em Enter Authtoken, ou leia o código QR do token em Meus tokens, e depois selecione Save. O app mostra o nome do token, o seu plano e o estado da conexão. Connected e Listening Sms significam que está pronto. Wrong Token significa que o token não é válido. Logout desconecta o app.

Deixe o app em execução. Os comandos só chegam ao celular enquanto o app de SMS está conectado.

Faça login no bot do Telegram #

  1. Abra o bot #

    Abra t.me/localtonet_sms_bot no Telegram e inicie uma conversa.

  2. Envie /login com a sua chave de API #

    Telegram
    /login <API_KEY>

    O bot responde You are now authorized as seguido do e-mail da sua conta. Uma chave errada é respondida com Invalid API key.

A partir de agora, o bot envia a esta conversa todo SMS que chega a um celular da sua conta. Cada mensagem mostra o nome do token do celular, o número do remetente e o texto.

A chave de API controla toda a sua conta, não apenas o SMS. Envie /login somente na conversa privada com o bot, nunca em um grupo. Se a chave vazar, altere-a no Painel com Alterar no cartão Chave de API e faça login no bot de novo com a nova chave.

Comandos #

/login recebe a sua chave de API. Os outros comandos recebem o AuthToken do celular a que se destinam. Separe as partes com um único espaço.

ComandoO que fazArgumentos
/login <API_KEY>Vincula esta conversa do Telegram à sua conta.A sua chave de API.
/helpMostra a lista de comandos.Nenhum.
/readallsms <AUTH_TOKEN> <HOURS>Lê a caixa de entrada de SMS do celular e envia a você as mensagens recebidas nas últimas horas.O token do celular e um número inteiro de horas. Sem o número, é lida a última hora.
/sendussdcode <AUTH_TOKEN> <USSD_CODE>Disca um código USSD no celular.O token do celular e o código, por exemplo *123#. O código não pode conter espaços.
/sendsms <AUTH_TOKEN> <PHONE_NUMBER> <MESSAGE>Envia um SMS pelo chip SIM do celular.O token do celular, o número do destinatário com código do país e sem espaços, e depois a mensagem. A mensagem pode conter espaços.

Exemplos #

Telegram
/readallsms <AUTH_TOKEN> 1
/sendussdcode <AUTH_TOKEN> *123#
/sendsms <AUTH_TOKEN> +15615557689 Hello
  • Depois de /readallsms, o bot responde Reading all Sms e envia as mensagens uma a uma.
  • Depois de /sendsms, o bot responde Sending Sms com o número. Quando o celular informa que a mensagem foi enviada e entregue, o bot repassa esses relatórios.
  • Depois de /sendussdcode, o bot responde Sending ussd code com o código. O bot apenas confirma que o código foi enviado ao celular.

Solução de problemas #

You need to authorize first. Use /login <apikey>

Esta conversa não está logada, ou o login foi perdido. Envie /login <API_KEY> de novo.

Invalid API key

Copie a chave de novo do Painel. Escreva o comando como /login, um espaço e depois a chave, sem nada depois dela.

You need to enter authtoken and …

O comando não tem o número certo de partes. Confira a tabela acima: /sendussdcode precisa de exatamente um token e um código, e /sendsms precisa de um token, um número e uma mensagem.

O bot confirma um comando, mas nada acontece no celular

Verifique se o token do comando é o mesmo com que o app de SMS entrou, se o app mostra Connected e se ele tem as permissões de SMS e de telefone.

Os SMS recebidos pararam de chegar ao Telegram

As mensagens são enviadas à conversa que fez login com a sua chave de API atual. Se você mudou a chave de API, envie /login com a nova chave. Verifique também se o app de SMS no celular continua conectado.

O painel diz Você precisa comprar saldo para usar este recurso.

Enviar SMS e executar códigos USSD pelo painel exige saldo na sua conta. Veja Planos e saldo.

Suporte