“飞信机器人/控制指令集”的版本间的差异

2009-08-01T01:17:56的版本

机器人控制指令

通过向 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 mobile/uri/sid	删除机器人好友列表里的好友^[9]
邀请好友	mobile-invite mobile desc^[10]	发出邀请使用飞信^[11]
屏蔽好友	buddy-block mobile/uri/sid
解除屏蔽	buddy-unblock mobile/uri/sid
接受邀请	accept_contact_request uri	只接受对方加机器人为好友。机器人不加对方
获取信息	contact-info mobile/uri	获取联系人信息
登录状态	status code status-desc code^[12] desc^[13]	修改登录状态
修改心情	impresa	显示一段话，可以是链接
修改呢称	nickname	显示在对方飞信上的名称
系统退出	exit mobile

注释说明

@@ 第19行： / 第19行： @@
 !功能!!命令格式(命令 对象 内容)!!说明
 |- span valign="top"  style="background:#fff;"
-|短　　信||sms mobile<ref>手机号</ref>/sid<ref>飞信号</ref>/uri<ref>统一定位符，有飞信好友格式和手机好友格式</ref> message<ref>短信内容，特殊字符要替换一下(空格=&amp;nbsp;换行=\n,>=&amp;gt;）</ref>||向用户发送短信
+|短　　信||sms mobile<ref>手机号</ref>/sid<ref>飞信号</ref>/uri<ref>统一定位符，有飞信好友格式和手机好友格式</ref> message<ref>短信内容，特殊字符要替换一下(空格=&amp;nbsp;换行=\n,>=&amp;gt;）</ref>||向用户发送短信<ref>返回参数：Service Unreachable(对方拒收飞信短信)，bad gateway(URI错)</ref>
 |- span valign="top" style="background:#EEEAE4;"
 |长 短 信||longsms mobile/sid/uri message||向用户发送长短信<ref>一条短信只能容纳140字节，超长的短信就要分成多条来发送，如果按长短信来发送，某些手机可以把多条并成一条显示</ref>