kf.go

package workwx

// CreateKfAccount 创建客服账号
func (c *WorkwxApp) CreateKfAccount(name, mediaID string) (openKfID string, err error) {
	resp, err := c.execKfAccountCreate(reqKfAccountCreate{
		Name:    name,
		MediaID: mediaID,
	})
	if err != nil {
		return "", err
	}
	return resp.OpenKfID, nil
}

// DeleteKfAccount 删除客服账号
func (c *WorkwxApp) DeleteKfAccount(openKfID string) (err error) {
	_, err = c.execKfAccountDelete(reqKfAccountDelete{
		OpenKfID: openKfID,
	})
	if err != nil {
		return err
	}
	return nil
}

// UpdateKfAccount 修改客服账号
func (c *WorkwxApp) UpdateKfAccount(openKfID, name, mediaID string) (err error) {
	_, err = c.execKfAccountUpdate(reqKfAccountUpdate{
		OpenKfID: openKfID,
		Name:     name,
		MediaID:  mediaID,
	})
	if err != nil {
		return err
	}
	return nil
}

// ListKfAccount 获取客服账号列表
func (c *WorkwxApp) ListKfAccount(offset, limit int64) ([]*KfAccount, error) {
	resp, err := c.execKfAccountList(reqKfAccountList{
		Offset: offset,
		Limit:  limit,
	})
	if err != nil {
		return nil, err
	}

	return resp.AccountList, nil
}

// AddKfContact 获取客服账号链接
func (c *WorkwxApp) AddKfContact(openKfID, scene string) (url string, err error) {
	resp, err := c.execAddKfContact(reqAddKfContact{
		OpenKfID: openKfID,
		Scene:    scene,
	})
	if err != nil {
		return "", err
	}
	return resp.URL, nil
}

// CreateKfServicer 创建接待人员
func (c *WorkwxApp) CreateKfServicer(openKfID string, userIDs []string, departmentIDs []int64) (resultList []*KfServicerResult, err error) {
	resp, err := c.execKfServicerCreate(reqKfServicerCreate{
		OpenKfID:      openKfID,
		UserIDs:       userIDs,
		DepartmentIDs: departmentIDs,
	})
	if err != nil {
		return nil, err
	}
	return resp.ResultList, nil
}

// DeleteKfServicer 删除接待人员
func (c *WorkwxApp) DeleteKfServicer(openKfID string, userIDs []string, departmentIDs []int64) (resultList []*KfServicerResult, err error) {
	resp, err := c.execKfServicerDelete(reqKfServicerDelete{
		OpenKfID:      openKfID,
		UserIDs:       userIDs,
		DepartmentIDs: departmentIDs,
	})
	if err != nil {
		return nil, err
	}
	return resp.ResultList, nil
}

// ListKfServicer 获取接待人员列表
func (c *WorkwxApp) ListKfServicer(openKfID string) ([]*KfServicer, error) {
	resp, err := c.execKfServicerList(reqKfServicerList{
		OpenKfID: openKfID,
	})
	if err != nil {
		return nil, err
	}

	return resp.ServicerList, nil
}

// GetKfServiceState 获取会话状态
func (c *WorkwxApp) GetKfServiceState(openKfID, externalUserID string) (KfServiceState, string, error) {
	resp, err := c.execKfServiceStateGet(reqKfServiceStateGet{
		OpenKfID:       openKfID,
		ExternalUserID: externalUserID,
	})
	if err != nil {
		return KfServiceStateUntreated, "", err
	}
	return resp.ServiceState, resp.ServicerUserID, nil
}

// TransKfServiceState 变更会话状态
func (c *WorkwxApp) TransKfServiceState(openKfID, externalUserID, servicerUserID string, ServiceState KfServiceState) (string, error) {
	resp, err := c.execKfServiceStateTrans(reqKfServiceStateTrans{
		OpenKfID:       openKfID,
		ExternalUserID: externalUserID,
		ServiceState:   ServiceState,
		ServicerUserID: servicerUserID,
	})
	if err != nil {
		return "", err
	}
	return resp.MsgCode, nil
}

// KfSyncMsg 微信客服获取消息列表
func (c *WorkwxApp) KfSyncMsg(openKfID, token, cursor string, limit int64, voiceFormat int) ([]KfMsg, int, string, error) {
	resp, err := c.execKfSyncMsg(reqKfSyncMsg{
		OpenKfID:    openKfID,
		Cursor:      cursor,
		Token:       token,
		Limit:       limit,
		VoiceFormat: voiceFormat,
	})
	if err != nil {
		return nil, 0, "", err
	}
	return resp.MsgList, resp.HasMore, resp.NextCursor, nil
}