账户中心 退出系统
开发文档 资讯·分享 技术交流 会员登录
phpGrace GSCMS 公众号系统
关联函数开发

关联函数说明

在系统添加自动回复可以满足基本的自动回复业务,利用关联函数可以满足特殊的需要。
原理 :
用户回复关键字 > 识别后台添加的回复数据并执行 > 自动寻找关联函数并运行 ( 有则执行 )

使用场景示例

1 实现自动回复同时再发送一条客服消息。
2 自动回复选择不回复,直接调用关联函数在函数内部自定义回复;

关联函数实现步骤

1 创建关联函数文件

文件位置 : 
站点根目录/wechat/wechatFunctions/对应公众号主键值(数字,在公众号账户列表查看)/fun回复数据主键值.php
如 : /wechat/wechatFunctions/8/fun300.php 
此函数执行条件 : 主键为 8 的公众号 用户回复关键字触发 id 为 300 的回复数据时会自动执行关联函数;

2 函数编写

在站点根目录/wechat/wechatFunctions/ 下有个关联函数模板 template.php,打开它复制到自己的关联函数文件内进行改进;
如 : 

<?php
// 自定义函数模板
// 演示 : 回复一个客服消息
function fun300($replyMsg, $graceWechat){
    $graceWechat->getAccessToken();
    $url = 'https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token='.$graceWechat->accessToken;
    $data = '{
         "touser":"'.$graceWechat->openId.'",
         "msgtype":"image",
         "image":
         {
            "media_id":"NCb6yOppPf2mYA-QjBKETsFIx1o7bx7f4SXJWZ8Sves"
         }
   }';
   // $graceWechat 公众号操作对象
    $res = $graceWechat->curlPost($url, $data);
}

函数基本规则

<?php
// 自定义函数模板
function fun具体的回复ID($replyMsg, $graceWechat){}
// $replyMsg 后台设置的回复数据信息
// $graceWechat 公众号操作对象包含用户信息、用户关键字信息、公众号相关操作能力

公众号操作对象

上面的示例中多处提及公众号操作对象,它是 graceWechat 类的实例,详细资料见手册 类库说明部分。