飞信机器人/控制指令集

来自Blueidea
< 飞信机器人
蓝色讨论 | 贡献2011-03-19T15:14:21的版本 命令集

跳转至: 导航搜索

机器人控制指令


概述

通过向 commands 目录放置命令文件(UTF-8编码),就能控制飞信机器人动作。飞信机器人在执行完指令后,会删除命令文件。

命令文件命名标准

手机号码_命令ID.cmd 如: 13764490999_000000.cmd

手机号码:因为本系统支持多个飞信号码同时登录,所以该参数指名发往哪个飞信号。
命令id: 随意命名,该id 用来反馈执行结果。有些指令,该参数可能无效。
开发者可以通过此id获取命令执行结果。


命令集

功能 命令格式(命令 对象 内容) 说明
短  信 sms mobile[1]/sid[2]/uri[3] message[4] 向用户发送短信[5]
长 短 信 longsms mobile/sid/uri message 向用户发送长短信[6]
智能消息 smartmsg mobile/sid/uri message 如果不在线,则发手机短信
在线消息 chat mobile/sid/uri message 只有当对方激活会话时有效
增加好友 buddy-add mobile desc[7] localname localname[8]仅为对方为手机用户时有效
删除好友 buddy-delete userid 删除机器人好友列表里的好友[9]
邀请好友 mobile-invite mobile desc[10] 发出邀请使用飞信[11]
屏蔽好友 buddy-block mobile/uri/sid
解除屏蔽 buddy-unblock mobile/uri/sid
接受邀请 accept_contact_request userid 只接受对方加机器人为好友。机器人不加对方
获取信息 contact-info mobile/uri 获取联系人信息
登录状态 status code
status-desc code[12] desc[13]
修改登录状态 获取信息 handle_contact_request userid 获取联系人信息
登录状态 status code
status-desc code[14] desc[15]
修改登录状态
修改心情 impresa 显示一段话,可以是链接
修改呢称 nickname 显示在对方飞信上的名称
系统退出 exit mobile

注释说明

  1. 手机号
  2. 飞信号
  3. 统一定位符,有飞信好友格式和手机好友格式
  4. 短信内容,特殊字符要替换一下(空格=&nbsp;换行=\n,>=&gt;)
  5. 返回参数:Service Unreachable(对方拒收飞信短信),bad gateway(URI错)
  6. 一条短信只能容纳140字节,超长的短信就要分成多条来发送,如果按长短信来发送,某些手机可以把多条并成一条显示
  7. 加为好友的申请信息
  8. 在本地的显示名称,只有本地有效,
  9. 尽量使用URI来删除,否则可能失败
  10. 邀请短信时显示邀请人的姓名
  11. 尽量少用以免帐号被封
  12. online/busy/away/hidden
  13. 个性化信息,如外出就餐等
  14. online/busy/away/hidden
  15. 个性化信息,如外出就餐等