短信机器人
本页内容 7 个章节
Localtonet 短信应用可以把 Android 手机变成短信终端:它会上报收到的短信、发送短信,并拨打 USSD 代码。你可以通过 Telegram 中的 Localtonet 短信机器人或控制台来控制它。
工作原理 #
- Localtonet 短信应用 运行在 Android 手机上,并使用 AuthToken 登录。
- Localtonet 短信机器人 是一个 Telegram 机器人。你用 API 密钥登录后,它会把你手机上收到的短信发给你,并接受针对这些手机的命令。
- 控制台同样可以发送短信和运行 USSD 代码:在 代理管理器 中设备的 短信 标签页上,以及在 我的令牌 中令牌的 短信设置 下。
开始之前 #
- 一部装有 SIM 卡的 Android 手机。短信应用适用于 Android 5.0 及更高版本。
- 该手机的 AuthToken。如果手机上已经运行着 Localtonet 应用,请使用同一个令牌:控制台通过令牌把短信应用与设备关联起来。
- 你的 API 密钥。它显示在 控制台 的 API 密钥 下。
- 一个 Telegram 账号,用来使用机器人。
设置短信应用 #
-
下载并安装 #
从 localtonet.com/download/localtonet-smsapp.zip 下载 Android 版短信应用。代理管理器中设备的 短信 标签页上的 下载短信应用 使用的是同一个链接。解压压缩包,并在手机上安装该应用。Android 会先要求你允许从该来源安装应用。
-
允许权限 #
打开 Localtonet Sms。应用会请求它工作所需的权限:
权限 用途 发送短信 通过手机的 SIM 卡发送消息。 读取短信、接收短信 读取收件箱并上报收到的消息。 电话 运行 USSD 代码。应用会拨打它们。 相机 扫描令牌的二维码。 通知 应用运行时显示它的通知。 -
用令牌登录 #
在 Enter Authtoken 中输入或粘贴令牌,或者扫描 我的令牌 中该令牌的二维码,然后选择 保存。应用会显示令牌名称、你的套餐和连接状态。出现 Connected 和 Listening Sms 表示已就绪。Wrong Token 表示令牌无效。Logout 会让应用退出登录。
请让应用保持运行。只有在短信应用处于连接状态时,命令才能到达手机。
登录 Telegram 机器人 #
-
打开机器人 #
在 Telegram 中打开 t.me/localtonet_sms_bot 并开始聊天。
-
用你的 API 密钥发送 /login #
Telegram/login <API_KEY>机器人会回复 You are now authorized as,后面跟着你账户的电子邮件。如果密钥错误,会回复 Invalid API key.
从现在起,机器人会把你账户下任何手机收到的每条短信发送到这个聊天。每条消息都会显示手机的令牌名称、发件人号码和短信内容。
API 密钥控制的是你的整个账户,而不只是短信。 只在与机器人的私聊中发送 /login,绝不要在群组里发送。如果密钥泄露,请在控制台的 API 密钥 卡片中用 更换 更换它,然后用新密钥重新登录机器人。
命令 #
/login 接受你的 API 密钥。其他命令接受它们所针对的手机的 AuthToken。各部分之间用单个空格分隔。
| 命令 | 作用 | 参数 |
|---|---|---|
/login <API_KEY> | 把这个 Telegram 聊天关联到你的账户。 | 你的 API 密钥。 |
/help | 显示命令列表。 | 无。 |
/readallsms <AUTH_TOKEN> <HOURS> | 读取手机的短信收件箱,并把最近几个小时内收到的消息发给你。 | 手机的令牌和一个表示小时数的整数。不带数字时,读取最近一小时。 |
/sendussdcode <AUTH_TOKEN> <USSD_CODE> | 在手机上拨打 USSD 代码。 | 手机的令牌和代码,例如 *123#。代码中不能包含空格。 |
/sendsms <AUTH_TOKEN> <PHONE_NUMBER> <MESSAGE> | 通过手机的 SIM 卡发送短信。 | 手机的令牌、带国家/地区代码且不含空格的收件人号码,然后是消息。消息中可以包含空格。 |
示例 #
/readallsms <AUTH_TOKEN> 1
/sendussdcode <AUTH_TOKEN> *123#
/sendsms <AUTH_TOKEN> +15615557689 Hello- 执行
/readallsms后,机器人会回复 Reading all Sms,然后逐条发送消息。 - 执行
/sendsms后,机器人会回复 Sending Sms 并附上号码。当手机报告消息已发送并已送达时,机器人会转发这些报告。 - 执行
/sendussdcode后,机器人会回复 Sending ussd code 并附上代码。机器人只确认代码已发送到手机。
故障排除 #
You need to authorize first. Use /login <apikey>
这个聊天没有登录,或者登录已失效。请再次发送 /login <API_KEY>。
Invalid API key
请从控制台重新复制密钥。命令写成 /login、一个空格、然后是密钥,后面不要有任何内容。
You need to enter authtoken and …
命令的组成部分数量不对。请查看上面的表格:/sendussdcode 恰好需要一个令牌和一个代码,/sendsms 需要一个令牌、一个号码和一条消息。
机器人确认了命令,但手机上没有任何反应
请检查命令中的令牌是否就是短信应用登录所用的令牌,应用是否显示 Connected,以及它是否有短信和电话权限。
收到的短信不再出现在 Telegram 中
消息会发送到用你当前的 API 密钥登录的聊天。如果你更换过 API 密钥,请用新密钥发送 /login。同时请检查手机上的短信应用是否仍处于连接状态。
控制台提示“你需要购买余额才能使用此功能”
在控制台中发送短信和运行 USSD 代码需要你的账户有余额。参见 套餐与余额。