mirror of
https://gitee.com/zoujingli/WeChatDeveloper.git
synced 2025-04-05 01:42:45 +08:00
229 lines
8.0 KiB
PHP
229 lines
8.0 KiB
PHP
<?php
|
||
|
||
// +----------------------------------------------------------------------
|
||
// | WeChatDeveloper
|
||
// +----------------------------------------------------------------------
|
||
// | 版权所有 2014~2024 ThinkAdmin [ thinkadmin.top ]
|
||
// +----------------------------------------------------------------------
|
||
// | 官方网站: https://thinkadmin.top
|
||
// +----------------------------------------------------------------------
|
||
// | 开源协议 ( https://mit-license.org )
|
||
// | 免责声明 ( https://thinkadmin.top/disclaimer )
|
||
// +----------------------------------------------------------------------
|
||
// | gitee 代码仓库：https://gitee.com/zoujingli/WeChatDeveloper
|
||
// | github 代码仓库：https://github.com/zoujingli/WeChatDeveloper
|
||
// +----------------------------------------------------------------------
|
||
|
||
namespace WeChat;
|
||
|
||
use WeChat\Contracts\BasicWeChat;
|
||
use WeChat\Contracts\Tools;
|
||
|
||
/**
|
||
* 客服消息处理
|
||
* Class Custom
|
||
* @package WeChat
|
||
*/
|
||
class Custom extends BasicWeChat
|
||
{
|
||
/**
|
||
* 添加客服帐号
|
||
* @param string $kf_account 客服账号
|
||
* @param string $nickname 客服昵称
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function addAccount($kf_account, $nickname)
|
||
{
|
||
$url = "https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, ['kf_account' => $kf_account, 'nickname' => $nickname]);
|
||
}
|
||
|
||
/**
|
||
* 修改客服帐号
|
||
* @param string $kfAccount 客服账号
|
||
* @param string $nickname 客服昵称
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function updateAccount($kfAccount, $nickname)
|
||
{
|
||
$url = "https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, ['kf_account' => $kfAccount, 'nickname' => $nickname]);
|
||
}
|
||
|
||
/**
|
||
* 删除客服帐号
|
||
* @param string $kfAccount 客服账号
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function deleteAccount($kfAccount)
|
||
{
|
||
$url = "https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, ['kf_account' => $kfAccount]);
|
||
}
|
||
|
||
/**
|
||
* 邀请绑定客服帐号
|
||
* @param string $kfAccount 完整客服帐号，格式为：帐号前缀@公众号微信号
|
||
* @param string $invite_wx 接收绑定邀请的客服微信号
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function inviteWorker($kfAccount, $invite_wx)
|
||
{
|
||
$url = 'https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN';
|
||
return $this->callPostApi($url, ['kf_account' => $kfAccount, 'invite_wx' => $invite_wx]);
|
||
}
|
||
|
||
/**
|
||
* 获取所有客服账号
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function getAccountList()
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN";
|
||
return $this->callGetApi($url);
|
||
}
|
||
|
||
/**
|
||
* 设置客服帐号的头像
|
||
* @param string $kf_account 客户账号
|
||
* @param string $image 头像文件位置
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function uploadHeadimg($kf_account, $image)
|
||
{
|
||
$url = "https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account={$kf_account}";
|
||
return $this->callPostApi($url, ['media' => Tools::createCurlFile($image)], false);
|
||
}
|
||
|
||
/**
|
||
* 客服接口-发消息
|
||
* @param array $data
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function send(array $data)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, $data);
|
||
}
|
||
|
||
/**
|
||
* 客服输入状态
|
||
* @param string $openid 普通用户（openid）
|
||
* @param string $command Typing:正在输入,CancelTyping:取消正在输入
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function typing($openid, $command = 'Typing')
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/message/custom/typing?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, ['touser' => $openid, 'command' => $command]);
|
||
}
|
||
|
||
/**
|
||
* 根据标签进行群发【订阅号与服务号认证后均可用】
|
||
* @param array $data
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function massSendAll(array $data)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, $data);
|
||
}
|
||
|
||
/**
|
||
* 根据OpenID列表群发【订阅号不可用，服务号认证后可用】
|
||
* @param array $data
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function massSend(array $data)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, $data);
|
||
}
|
||
|
||
/**
|
||
* 删除群发【订阅号与服务号认证后均可用】
|
||
* @param integer $msg_id 发送出去的消息ID
|
||
* @param null|integer $article_idx 要删除的文章在图文消息中的位置，第一篇编号为1，该字段不填或填0会删除全部文章
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function massDelete($msg_id, $article_idx = null)
|
||
{
|
||
$data = ['msg_id' => $msg_id];
|
||
is_null($article_idx) || $data['article_idx'] = $article_idx;
|
||
$url = "https://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, $data);
|
||
}
|
||
|
||
/**
|
||
* 预览接口【订阅号与服务号认证后均可用】
|
||
* @param array $data
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function massPreview(array $data)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, $data);
|
||
}
|
||
|
||
/**
|
||
* 查询群发消息发送状态【订阅号与服务号认证后均可用】
|
||
* @param integer $msgId 群发消息后返回的消息id
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function massGet($msgId)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/message/mass/get?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, ['msg_id' => $msgId]);
|
||
}
|
||
|
||
/**
|
||
* 获取群发速度
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function massGetSeed()
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/message/mass/speed/get?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, []);
|
||
}
|
||
|
||
/**
|
||
* 设置群发速度
|
||
* @param integer $speed 群发速度的级别
|
||
* @return array
|
||
* @throws Exceptions\InvalidResponseException
|
||
* @throws Exceptions\LocalCacheException
|
||
*/
|
||
public function massSetSeed($speed)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/message/mass/speed/set?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, ['speed' => $speed]);
|
||
}
|
||
} |