Bot de SMS
Nesta página 7 seções
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 #
-
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.
-
Conceda as permissões #
Abra Localtonet Sms. O app pede as permissões de que precisa para funcionar:
Permissão Necessária para Enviar SMS Enviar mensagens pelo chip SIM do celular. Ler SMS, receber SMS Ler a caixa de entrada e informar as mensagens recebidas. Chamadas telefônicas Executar códigos USSD. O app os disca. Câmera Ler o código QR de um token. Notificações Mostrar a notificação do app enquanto ele está em execução. -
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 #
-
Abra o bot #
Abra t.me/localtonet_sms_bot no Telegram e inicie uma conversa.
-
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.
| Comando | O que faz | Argumentos |
|---|---|---|
/login <API_KEY> | Vincula esta conversa do Telegram à sua conta. | A sua chave de API. |
/help | Mostra 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 #
/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.