开发者文档
简体中文

入门

使用应用

从注册到聊天、群组、照片、机器人和链接——为初次使用 Pabal 应用的用户准备的指南。

目前提供的应用

Pabal 应用目前提供 macOS 和 Windows 桌面应用以及 Android 应用。它以官方 Telegram 应用为基础、针对 Pabal 服务器做了适配,如果你用过 Telegram,会觉得界面很熟悉。应用请从服务器运营方那里获取。iPhone 应用的第一个版本已提交 App Store 审核,Android 应用已在 Google Play 上架(也可以在 pabal.me 下载 APK),Linux 应用和 Apple Watch 应用正在准备中。

注册和登录

  1. 输入手机号码。选择国家、输入号码,然后点下一步。
  2. 接收验证码。根据服务器的运营方式,验证码会通过短信(SMS)发来,或者先询问你的电子邮件地址再通过邮件发来,或者由运营方直接告诉你。
  3. 输入验证码。如果是已有账号,会直接登录;如果是新号码,会询问你的名字。输入名字后,注册就完成了。
应用显示的提示含义与处理方法
号码无效请重新检查号码。服务器暂停接受新注册时也会这样显示。
号码已被封禁运营方封禁了此号码。在停用状态下注销的账号,其号码在注销后的一段时间内(默认 1 年,运营方可以设得更长)也会这样被拒绝。请联系运营方。
尝试次数过多同一号码请求验证码过于频繁。请按提示的时间等待后再试(默认:间隔 60 秒,每天 10 次)。
验证码错误请重新输入。输错多次(默认 5 次)后,该验证码会被锁定,需要从输入号码重新开始。
验证码已过期验证码默认只在 5 分钟内有效。请重新输入号码,获取新的验证码。
绝对不要把验证码告诉别人

知道验证码的人就能登录你的账号。运营方或机器人绝不会向你索要验证码。

完善个人资料

  • 名字和简介:在“设置 → 我的资料”中修改。
  • 用户名:让别人无需手机号码就能找到你。设置后,也可以通过 pabal.me/用户名 链接打开你的资料。
  • 头像:在设置中上传照片后,会显示在对话列表和个人资料中。以前的照片会保留在照片列表中,可以重新选用或删除。

聊天

  • 查找对方:在左上角的搜索框中输入对方的用户名。也可以用通讯录中保存的号码查找。
  • 消息:发出的消息会立即送达对方的所有设备。已发送的消息可以修改(右键 → 编辑)或删除,对方的屏幕上也会同步更新。
  • 照片和文件:把文件拖进来,或点回形针按钮发送。照片会作为照片发出,其他文件则作为文件发出。文件的名称和格式会原样保留,大小上限由运营方设定(默认 2GB)。视频和语音也可以作为文件发送,对方下载后即可打开,但能在应用内直接播放的视频和语音消息还不支持。
  • 多台设备:同一个账号可以在多台电脑上登录。在一台设备上发送的消息在其他设备上也能看到,离线的设备重新打开后会补收错过的对话。
  • 导出我的数据:在桌面应用的“设置 → 高级 → Export Pabal data”中,可以把对话、照片、文件和账号信息保存到电脑上。每天最多开始 3 次;导出过程中如果服务器重启,就要从头再来。
  • 通话:点对话顶部的电话按钮发起一对一通话。群组通话尚未支持。

通知

应用关闭时如何提醒你有新消息,因应用而异。

应用应用关闭时备注
Android会收到通知新消息以通知形式弹出,来电会响铃。通知内容用每部手机各不相同的密钥加密,经由 Google 送达
iPhone从下一个版本开始已提交 App Store 审核的第一个版本(1.0)没有推送通知,在应用打开期间接收消息。带推送的 1.1 正在内部测试
macOS、Windows运行期间应用运行时,会通过电脑的系统通知显示。关闭应用后再打开,会补收错过的对话

要在 Android 上收到通知

  1. 把应用安装或更新到最新版(从运营方网站 pabal.me 获取的 APK)。在加入通知功能之前下载的应用收不到通知。
  2. 安装或更新后,打开一次应用。这时应用会把这部手机作为接收通知的设备登记到服务器。更新后登录状态保持不变。
  3. Android 询问是否允许通知时,点允许。之后也可以在手机的“设置 → 应用 → Pabal → 通知”中打开。
  • 用完后在最近使用的应用列表中把应用划掉,仍然能收到通知。但不要点设置中的强行停止——在你自己再次打开应用之前,Android 不会传递通知。
  • 如果通知延迟或收不到,请在手机的电池设置中把 Pabal 设为不受限制(不做省电优化)。
  • 关闭某个对话的通知后,该对话不会弹出通知。
  • 视运营方的设置,通知中可能只显示发送者,不显示消息内容。
  • 如果已关闭的应用过了很久才被唤醒,来电可能会先挂断。这时在对话中回拨即可。
  • 只有服务器上启用了通知,才能收到通知。如果你在运营服务器,请参阅服务器安装——Android 推送通知。

群组

  1. 左上角菜单 → 新建群组。
  2. 选择成员(按用户名搜索),再设定群组名称即可。
  3. 之后可以在群组信息中添加或移除成员,也可以修改名称。通过邀请链接(pabal.me/+…)加入的功能尚在准备中,请在群组信息中直接添加成员。

机器人也可以作为群组成员加入。加入群组的机器人可以接收并回复群组中的消息。

使用机器人

机器人是由程序控制的账号。搜索机器人的用户名(以 bot 结尾)并打开,然后点开始即可。点击机器人发来的按钮后,机器人会回复你或修改消息。

如果想创建自己的机器人,请搜索 @BotFather 并发送 /newbot。详细方法请见创建机器人。

给语音机器人打电话

有些机器人可以接听电话。这类机器人由 AI 语音模型代为应答(语音机器人)。只有在服务器运营方开启了语音机器人的服务器上才能使用,而且正式开放前只有运营方指定的测试者可以拨打。

  1. 通话按钮:点语音机器人对话顶部或资料页上的电话按钮。这个按钮只对能接听电话的机器人显示,而且只在支持语音机器人通话的应用版本中显示。没有视频通话。
  2. 确认窗口:首先会出现“An AI answers this call”(此通话由 AI 接听)窗口。阅读以下内容:机器人不是人,你听到的声音也是 AI 生成的;与人与人之间的通话不同,这通电话不是端到端加密的;声音会发送到哪里;机器人所有者会收到什么。如果你年满 19 周岁,点“I'm 19 or older · Call”(我已年满 19 周岁 · 呼叫)。如果不想打,就取消——给机器人发消息不受影响。桌面版和 Android 在第一次给该机器人打电话时询问,iPhone 每次拨打都会询问。
  3. 接通后,先会听到“You're now talking to an AI voice bot.”(已接通 AI 语音机器人)提示,然后机器人打招呼。问机器人时,它总会回答自己是 AI。如果选择了保存对话,通话界面上会显示“Conversation kept as text”(对话以文字保存)(没有单独的提示语音)。
  4. 挂断:和普通通话一样,用红色按钮挂断。机器人挂断,或达到机器人设定的最长时间(通常为几分钟)时,通话也会结束。结束后,与机器人的对话中会留下通话记录。
  • 声音的去向:应用 → Pabal 的语音服务器 → Google(Vertex AI 的 Gemini Live API,美国艾奥瓦州)。Pabal 不保存通话声音,只把通话记录(谁、何时、多长)保留 180 天(对话中留下的通话记录消息会一直保留,直到你删除)。Google 在生成回答后不保留声音和文字,但被自动检查怀疑为滥用的内容可能会被记录最长 90 天(与确认窗口的说明相同)。
  • 机器人所有者收到的内容:你的名字、账号 ID 和应用语言(不包括手机号码和用户名)、通话的时间和时长,以及机器人功能(例如订单查询)用到的值。所有者收不到通话声音。如果机器人会以文字形式接收对话内容,接通时会先播放“What is said on this call is written down and sent to the bot's owner.”(本次通话的对话内容会被写成文字并发送给机器人所有者)提示。对于由机器人开发者的服务器直接接收声音的机器人(音频流模式),确认窗口的内容会不同,通话声音会发送到那台服务器。
  • 请不要说出银行卡号、居民登记号、密码或验证码。语音机器人被设计为不会询问这些信息,Pabal 也不会把看起来像银行卡号或居民登记号的数字传给机器人的功能,并会在文字记录中遮盖,但无法全部识别(分开说的数字、用词语念出的数字,以及密码和验证码都无法遮盖)。
  • 通话界面的名字下方会显示“@{username} · AI · Bot”和“AI-generated voice · Call audio is processed by Google”(AI 生成的声音 · 通话声音由 Google 处理)。在包含确认窗口的应用版本发布之前,机器人不会显示通话按钮。
  • 连接出现问题时,会听到“Sorry, we've lost the connection. Ending the call now.”(抱歉,连接出现问题,通话即将结束)后挂断。机器人繁忙或今天的通话时长已用完等情况下,通话会以忙音结束。一个人给机器人打电话也有每日时长和每小时次数的限额,刚注册不久的账号可能无法拨打。

保存对话(准备中——目前 pabal.me 上不能使用):如果想以后以文字形式再看一遍通话中的对话,请打开确认窗口中的复选框“Keep this call's conversation as text in my chat”(将本次通话的对话以文字保存在我的聊天中)(默认关闭)。

  • 桌面版和 Android 会按机器人记住这个选择。要更改,请点该机器人聊天右上角的 ⋮ → “Keep conversation”(保存对话)(开启时名称后面有 ✓)。iPhone 和 Apple Watch 每次拨打时选择。
  • 通话结束后,对话会以静默消息(没有通知)的形式留在与该机器人的聊天中通话记录的正下方。粗体标题“Call conversation”(通话对话记录)下面,用“Me:”(我)和机器人的名字标明谁说了什么;内容较长时会分成多条消息。
  • 这些文字只有你能看到。不会发给机器人或机器人所有者,机器人所有者也无法知道你是否做了这个选择。可以像其他消息一样删除。
  • 看起来像银行卡号或居民登记号的数字会用 * 遮住(无法全部识别)。
  • 未能保存时,通话记录下方会留下一行“This call's conversation could not be kept.”(本次通话的对话未能保存)。
  • 它与机器人所有者收到的文字记录是两回事——文字记录会发给机器人所有者,并且在接通时会播放提示语音。

如果想创建语音机器人,请参阅语音机器人文档;想了解语音机器人能做什么,请参阅 AI 智能体。

用 Apple Watch 给语音机器人打电话(准备中)

用 Apple Watch 应用,不带 iPhone 也能给语音机器人打电话。出门运动时可以把手机留在家里。目前正在内部测试,还无法获取。

  • 登录:不能在手表上注册。请用已有账号的电话号码和验证码登录。
  • 拨打:在机器人列表中选择机器人后,每次通话都会显示完整的确认窗口。读完后点“I'm 19 or older · Call”(我已年满 19 周岁 · 呼叫)。保存对话的开关也在这里。
  • 收听:建议使用 AirPods 之类的蓝牙耳机。
  • 通话期间看不到体能训练应用的界面——手表会显示“End Call to Continue”。
  • 不能用手表拨打的机器人:使用工具、MCP 服务器、自有模型密钥、音频流模式或机器人所有者文字记录的机器人,暂时还不能拨打(WATCH_NOT_YET)。这类机器人请用手机或电脑拨打。
  • 通话结束后,手机和电脑应用中与该机器人的聊天里会留下通话记录。手表应用暂时还没有消息功能。

许可机器人给我打电话(即将推出)

像预约确认、叫醒、配送通知这样,你许可过的机器人可以主动给你打电话。打电话的是 AI 语音。带许可窗口的应用版本尚未发布,pabal.me 也在等待法律审查,所以现在还不能使用。应用中的文字目前以英语显示,因此这里直接引用英语原文。

  1. 许可:在机器人聊天或资料页的菜单中点按 Allow calls…(许可来电…),或点按该机器人在聊天中发来的许可链接。许可窗口会显示由 AI 拨打、目的、机器人所有者、声音的去向和免打扰时段。如果已满 19 岁,点按 I am 19 or older · Allow(我已满 19 岁 · 许可)。
  2. 来电时:响铃时机器人名称后带“(AI)”,并显示“AI voice bot · Pabal never asks for codes”(AI 语音机器人 · Pabal 从不索要验证码)。接听后先播放 Pabal 的提示语音,然后机器人说出名称、自己是 AI 以及来电目的。
  3. 关闭:菜单中的 Stop calls from this bot(停止此机器人的来电)、拉黑机器人、举报,随时都会立即关闭。通话中明确说出“别再给我打电话”之类的话,也会当场关闭(只说“停”则取决于 AI 的判断)。
  • 免打扰时段:夜间 21:00–08:00 不会来电。可以在许可窗口中扩大,但不能缩短。目的为叫醒的机器人,可以在免打扰时段内选择只接叫醒电话的时间(15 分钟–2 小时)。勿扰模式、睡眠模式下可能不会响铃。
  • 暂停中:不接、拒接或接起后马上挂断,该机器人 24 小时内不会再打来。用菜单中的 I can take calls now(现在可以接听)提前解除。
  • 许可过的机器人列表:在隐私设置中的 Bots allowed to call me(许可来电的机器人)里查看、关闭或重新许可。
  • 未接来电:如果设备确实响了铃而你没接、没有拉黑机器人、且该机器人的聊天中没有未读消息,聊天中会留下“Missed AI bot call”(AI 机器人未接来电——标为已读,无通知)。有未读消息,或因免打扰时段、暂停而没有响铃时,不会留下。
  • 机器人所有者收到的内容:“What the bot's owner gets: your Pabal id, whether your permission is on (its call requests show it), whether you answered, when the call started and how long it lasted, and who hung up. The bot's owner may use this only to make calls for the purposes above, and must delete it once your permission is off. A missed call and a declined one look the same. What was said in the call is not sent.”——你的 Pabal ID、许可是否开启、是否接听、通话开始时间和时长、谁挂断的。通话内容不会发出。
  • 机器人打来的电话不是端到端加密的——声音会经过 Pabal 的服务器和 AI 提供方。接听后,通话期间声音会发往 Google(美国艾奥瓦)处理,Pabal 不录音。
  • 保存对话:勾选许可窗口中的复选框后,该机器人打来的电话的对话只以文字保存在你自己的聊天中(不会发给机器人所有者)。
  • 用手表接听:在 Pabal 手表应用中开启后,Apple Watch 也会一起响铃。
  • 共用设备:任何已登录的设备都能接听,无论谁接,机器人都会说明目的和提示内容。多人共用的电脑请退出登录。
  • 锁屏:在 Android 14 及以上,如果没有允许全屏通知,锁屏上会以通知而不是来电界面出现。iPhone 和 Apple Watch 会像电话一样响铃。
  • 回答未满 19 岁的话,一年内不能与任何机器人语音通话,给机器人的许可也会全部消失。不许可也不会影响你使用 Pabal。

面向机器人所有者的说明见语音机器人——机器人打来的电话。

在浏览器中打开 pabal.me/用户名 链接时,会出现“在应用中打开”页面。点击按钮后,Pabal 应用会打开,并进入与该用户或机器人的对话。如果还没有应用,请先按照页面上的说明获取应用。(群组邀请链接 pabal.me/+… 也会打开应用,但通过链接加入群组的功能尚在准备中。)

保护账号

  • 不要把验证码告诉别人。
  • 已登录的设备可以在应用设置的设备中查看(桌面应用在“隐私与安全 → 活跃会话”)。不认识的设备请在那里结束——被结束的设备会立即退出登录。登录不满 24 小时的设备不能结束其他设备(这样用偷来的验证码登录的设备就无法把主人赶出去)。这时应用(Android 和桌面版)不会显示任何提示,看起来就像点了“结束”却什么也没发生。遇到这种情况,或者电脑丢失时,请向运营方申请退出所有设备。运营方可以在管理页面中一次性让所有设备退出登录。
  • 更换手机号码(在手机应用的设置中点击号码)只在运营方开启了该功能的服务器上可用——默认关闭,应用会显示错误。开启后,验证码会通过短信发到新号码;更换之后,就不能再用旧号码登录这个账号。不能换成其他账号正在使用的号码或被封禁的号码。
  • 暂不支持两步验证(云密码)。

尚不支持的功能

频道和超级群组、通过邀请链接加入群组、能在应用内直接播放的视频和语音消息、把多张打包成一组显示的相册(发送后会逐条分开送达)、群组通话、私密聊天、粗体和斜体等格式、iPhone 应用(审核中——第一个版本没有推送通知)、Apple Watch 应用中的消息(手表应用正在准备中,只能给语音机器人打电话)。即使应用中显示了相应按钮,服务器也可能尚未支持,从而出现错误。完整列表请见 Pabal 简介。