跳到内容
Localtonet Localtonet 控制台

短信机器人

获取本页帮助
本页内容 7 个章节
  1. 工作原理
  2. 开始之前
  3. 设置短信应用
  4. 下载并安装
  5. 允许权限
  6. 用令牌登录
  7. 登录 Telegram 机器人
  8. 打开机器人
  9. 用你的 API 密钥发送 /login
  10. 命令
  11. 示例
  12. 故障排除
  13. 相关页面

Localtonet 短信应用可以把 Android 手机变成短信终端:它会上报收到的短信、发送短信,并拨打 USSD 代码。你可以通过 Telegram 中的 Localtonet 短信机器人或控制台来控制它。

工作原理 #

  • Localtonet 短信应用 运行在 Android 手机上,并使用 AuthToken 登录。
  • Localtonet 短信机器人 是一个 Telegram 机器人。你用 API 密钥登录后,它会把你手机上收到的短信发给你,并接受针对这些手机的命令。
  • 控制台同样可以发送短信和运行 USSD 代码:在 代理管理器 中设备的 短信 标签页上,以及在 我的令牌 中令牌的 短信设置 下。

开始之前 #

  • 一部装有 SIM 卡的 Android 手机。短信应用适用于 Android 5.0 及更高版本。
  • 该手机的 AuthToken。如果手机上已经运行着 Localtonet 应用,请使用同一个令牌:控制台通过令牌把短信应用与设备关联起来。
  • 你的 API 密钥。它显示在 控制台 的 API 密钥 下。
  • 一个 Telegram 账号,用来使用机器人。

设置短信应用 #

  1. 下载并安装 #

    从 localtonet.com/download/localtonet-smsapp.zip 下载 Android 版短信应用。代理管理器中设备的 短信 标签页上的 下载短信应用 使用的是同一个链接。解压压缩包,并在手机上安装该应用。Android 会先要求你允许从该来源安装应用。

  2. 允许权限 #

    打开 Localtonet Sms。应用会请求它工作所需的权限:

    权限用途
    发送短信通过手机的 SIM 卡发送消息。
    读取短信、接收短信读取收件箱并上报收到的消息。
    电话运行 USSD 代码。应用会拨打它们。
    相机扫描令牌的二维码。
    通知应用运行时显示它的通知。
  3. 用令牌登录 #

    在 Enter Authtoken 中输入或粘贴令牌,或者扫描 我的令牌 中该令牌的二维码,然后选择 保存。应用会显示令牌名称、你的套餐和连接状态。出现 Connected 和 Listening Sms 表示已就绪。Wrong Token 表示令牌无效。Logout 会让应用退出登录。

请让应用保持运行。只有在短信应用处于连接状态时,命令才能到达手机。

登录 Telegram 机器人 #

  1. 打开机器人 #

    在 Telegram 中打开 t.me/localtonet_sms_bot 并开始聊天。

  2. 用你的 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 卡发送短信。手机的令牌、带国家/地区代码且不含空格的收件人号码,然后是消息。消息中可以包含空格。

示例 #

Telegram
/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 代码需要你的账户有余额。参见 套餐与余额。

支持