134 lines
4.5 KiB
PHP
134 lines
4.5 KiB
PHP
|
<?php
|
|||
|
|
/**
|
|||
|
|
* +----------------------------------------------------------------------
|
|||
|
|
* | CRMEB [ CRMEB赋能开发者，助力企业发展 ]
|
|||
|
|
* +----------------------------------------------------------------------
|
|||
|
|
* | Copyright (c) 2016~2022 https://www.crmeb.com All rights reserved.
|
|||
|
|
* +----------------------------------------------------------------------
|
|||
|
|
* | Licensed CRMEB并不是自由软件，未经许可不能去掉CRMEB相关版权
|
|||
|
|
* +----------------------------------------------------------------------
|
|||
|
|
* | Author: CRMEB Team <admin@crmeb.com>
|
|||
|
|
* +----------------------------------------------------------------------
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
namespace crmeb\services\wechat\client\work;
|
|||
|
|
|
|||
|
|
|
|||
|
|
use crmeb\services\wechat\client\BaseClient;
|
|||
|
|
use EasyWeChat\Kernel\HttpClient\Response;
|
|||
|
|
use Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface;
|
|||
|
|
use Symfony\Contracts\HttpClient\ResponseInterface;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 联系客服
|
|||
|
|
* Class ContactWayClient
|
|||
|
|
* @author 等风来
|
|||
|
|
* @email 136327134@qq.com
|
|||
|
|
* @date 2023/9/19
|
|||
|
|
* @package crmeb\services\wechat\client\work
|
|||
|
|
*/
|
|||
|
|
class ContactWayClient extends BaseClient
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 配置客户联系「联系我」方式.
|
|||
|
|
* @param int $type
|
|||
|
|
* @param int $scene
|
|||
|
|
* @param array $config
|
|||
|
|
* @return Response|ResponseInterface
|
|||
|
|
* @throws TransportExceptionInterface
|
|||
|
|
* @author 等风来
|
|||
|
|
* @email 136327134@qq.com
|
|||
|
|
* @date 2023/9/15
|
|||
|
|
*/
|
|||
|
|
public function create(int $type, int $scene, array $config = []): ResponseInterface|Response
|
|||
|
|
{
|
|||
|
|
$params = array_merge([
|
|||
|
|
'type' => $type,
|
|||
|
|
'scene' => $scene,
|
|||
|
|
], $config);
|
|||
|
|
|
|||
|
|
return $this->api->postJson('cgi-bin/externalcontact/add_contact_way', $params);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 更新企业已配置的「联系我」方式.
|
|||
|
|
* @param string $configId
|
|||
|
|
* @param array $config
|
|||
|
|
* @return Response|ResponseInterface
|
|||
|
|
* @throws TransportExceptionInterface
|
|||
|
|
* @author 等风来
|
|||
|
|
* @email 136327134@qq.com
|
|||
|
|
* @date 2023/9/15
|
|||
|
|
*/
|
|||
|
|
public function update(string $configId, array $config = []): ResponseInterface|Response
|
|||
|
|
{
|
|||
|
|
$params = array_merge([
|
|||
|
|
'config_id' => $configId,
|
|||
|
|
], $config);
|
|||
|
|
|
|||
|
|
return $this->api->postJson('cgi-bin/externalcontact/update_contact_way', $params);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 删除企业已配置的「联系我」方式.
|
|||
|
|
* @param string $configId
|
|||
|
|
* @return Response|ResponseInterface
|
|||
|
|
* @throws TransportExceptionInterface
|
|||
|
|
* @author 等风来
|
|||
|
|
* @email 136327134@qq.com
|
|||
|
|
* @date 2023/9/15
|
|||
|
|
*/
|
|||
|
|
public function delete(string $configId): ResponseInterface|Response
|
|||
|
|
{
|
|||
|
|
return $this->api->postJson('cgi-bin/externalcontact/del_contact_way', [
|
|||
|
|
'config_id' => $configId,
|
|||
|
|
]);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 获取企业已配置的「联系我」列表，注意，该接口仅可获取2021年7月10日以后创建的「联系我」
|
|||
|
|
* @param string $cursor 分页查询使用的游标，为上次请求返回的 next_cursor
|
|||
|
|
* @param int $limit 每次查询的分页大小，默认为100条，最多支持1000条
|
|||
|
|
* @param int|null $startTime 「联系我」创建起始时间戳, 不传默认为90天前
|
|||
|
|
* @param int|null $endTime 「联系我」创建结束时间戳, 不传默认为当前时间
|
|||
|
|
* @return Response|ResponseInterface
|
|||
|
|
* @throws TransportExceptionInterface
|
|||
|
|
* @author 等风来
|
|||
|
|
* @email 136327134@qq.com
|
|||
|
|
* @date 2023/9/15
|
|||
|
|
*/
|
|||
|
|
public function list(string $cursor = '', int $limit = 100, int $startTime = null, int $endTime = null): ResponseInterface|Response
|
|||
|
|
{
|
|||
|
|
$data = [
|
|||
|
|
'cursor' => $cursor,
|
|||
|
|
'limit' => $limit,
|
|||
|
|
];
|
|||
|
|
if ($startTime) {
|
|||
|
|
$data['start_time'] = $startTime;
|
|||
|
|
}
|
|||
|
|
if ($endTime) {
|
|||
|
|
$data['end_time'] = $endTime;
|
|||
|
|
}
|
|||
|
|
return $this->api->postJson('cgi-bin/externalcontact/list_contact_way', $data);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 结束临时会话
|
|||
|
|
* @param string $userId 企业成员的user_id
|
|||
|
|
* @param string $externalUserId 客户的外部联系人user_id
|
|||
|
|
* @return Response|ResponseInterface
|
|||
|
|
* @throws TransportExceptionInterface
|
|||
|
|
* @author 等风来
|
|||
|
|
* @email 136327134@qq.com
|
|||
|
|
* @date 2023/9/15
|
|||
|
|
*/
|
|||
|
|
public function closeTempChat(string $userId, string $externalUserId): ResponseInterface|Response
|
|||
|
|
{
|
|||
|
|
return $this->api->postJson('cgi-bin/externalcontact/close_temp_chat', [
|
|||
|
|
'userid' => $userId,
|
|||
|
|
'external_userid' => $externalUserId
|
|||
|
|
]);
|
|||
|
|
}
|
|||
|
|
}
|