Files
ai-agent/web/app/dashboard/channels/_components/edit.tsx
T
mlogclub fbabb174d2 feat: add WeChat MP channel support and enhance widget configuration
- Updated output path for generated enums to reflect new structure.
- Enhanced ChannelController to handle WeChat MP OAuth authorization and callback.
- Introduced WechatMPChannelConfig DTO for WeChat MP specific configurations.
- Modified WidgetConfigResponse to include channel type and external source.
- Added enums for WeChat MP channel type and external source.
- Implemented OAuth flow for WeChat MP, including state signing and verification.
- Updated frontend forms to accommodate WeChat MP configurations.
- Enhanced API interactions to support WeChat MP external ID and source.
- Updated generated enums to include WeChat MP external source.
2026-04-27 15:42:04 +08:00

843 lines
28 KiB
TypeScript

"use client"
import { useEffect, useMemo, useState } from "react"
import { zodResolver } from "@hookform/resolvers/zod"
import { Controller, Resolver, useForm, useWatch } from "react-hook-form"
import { z } from "zod/v4"
import { CopyIcon, ExternalLinkIcon } from "lucide-react"
import { toast } from "sonner"
import { OptionCombobox } from "@/components/option-combobox"
import { ProjectDialog } from "@/components/project-dialog"
import { Button } from "@/components/ui/button"
import {
Field,
FieldContent,
FieldError,
FieldLabel,
} from "@/components/ui/field"
import { Input } from "@/components/ui/input"
import { Textarea } from "@/components/ui/textarea"
import {
type AIAgent,
type AdminChannel,
type CreateAdminChannelPayload,
type WxWorkKFAccount,
fetchAIAgentsAll,
fetchChannel,
fetchWxWorkKFAccounts,
} from "@/lib/api/admin"
type ChannelFormDialogProps = {
open: boolean
saving: boolean
itemId: number | null
onOpenChange: (open: boolean) => void
onSubmit: (payload: CreateAdminChannelPayload) => Promise<void>
}
const channelTypeOptions = [
{ value: "web", label: "Web 站点" },
{ value: "wechat_mp", label: "微信公众号" },
{ value: "wxwork_kf", label: "企业微信客服" },
] as const
const oauthScopeOptions = [
{ value: "snsapi_base", label: "静默授权" },
{ value: "snsapi_userinfo", label: "用户信息授权" },
] as const
const widgetPositionOptions = [
{ value: "right", label: "右下角" },
{ value: "left", label: "左下角" },
] as const
type WebChannelConfig = {
title?: string
subtitle?: string
themeColor?: string
position?: "left" | "right"
width?: string
}
type WechatMPChannelConfig = WebChannelConfig & {
appId?: string
appSecret?: string
oauthScope?: "snsapi_base" | "snsapi_userinfo"
oauthEnabled?: boolean
}
const defaultWebChannelConfig: Required<WebChannelConfig> = {
title: "在线客服",
subtitle: "欢迎咨询",
themeColor: "#2563eb",
position: "right",
width: "380px",
}
const schema = z
.object({
channelType: z.enum(["web", "wechat_mp", "wxwork_kf"], "请选择渠道类型"),
aiAgentId: z.string().trim().regex(/^\d+$/, "请选择 AI Agent"),
name: z.string().trim().min(1, "渠道名称不能为空"),
openKfId: z.string().trim(),
widgetTitle: z.string().trim(),
widgetSubtitle: z.string().trim(),
widgetThemeColor: z.string().trim(),
widgetPosition: z.enum(["left", "right"]),
widgetWidth: z.string().trim(),
wechatAppId: z.string().trim(),
wechatAppSecret: z.string().trim(),
wechatOAuthScope: z.enum(["snsapi_base", "snsapi_userinfo"]),
remark: z.string().trim(),
})
.superRefine((values, ctx) => {
if (values.channelType === "wxwork_kf" && !values.openKfId.trim()) {
ctx.addIssue({
code: "custom",
path: ["openKfId"],
message: "请选择企业微信客服账号",
})
}
if (values.channelType === "wechat_mp") {
if (!values.wechatAppId.trim()) {
ctx.addIssue({
code: "custom",
path: ["wechatAppId"],
message: "请填写公众号 AppID",
})
}
if (!values.wechatAppSecret.trim()) {
ctx.addIssue({
code: "custom",
path: ["wechatAppSecret"],
message: "请填写公众号 AppSecret",
})
}
}
})
type EditForm = z.infer<typeof schema>
const resolver = zodResolver(schema as never) as Resolver<
z.input<typeof schema>,
undefined,
z.output<typeof schema>
>
const emptyForm: EditForm = {
channelType: "web",
aiAgentId: "",
name: "",
openKfId: "",
widgetTitle: defaultWebChannelConfig.title,
widgetSubtitle: defaultWebChannelConfig.subtitle,
widgetThemeColor: defaultWebChannelConfig.themeColor,
widgetPosition: defaultWebChannelConfig.position,
widgetWidth: defaultWebChannelConfig.width,
wechatAppId: "",
wechatAppSecret: "",
wechatOAuthScope: "snsapi_base",
remark: "",
}
function parseOpenKfId(configJson: string): string {
if (!configJson.trim()) {
return ""
}
try {
const parsed = JSON.parse(configJson) as { openKfId?: string }
return typeof parsed.openKfId === "string" ? parsed.openKfId.trim() : ""
} catch {
return ""
}
}
function parseWebChannelConfig(configJson: string): Required<WebChannelConfig> {
if (!configJson.trim()) {
return defaultWebChannelConfig
}
try {
const parsed = JSON.parse(configJson) as WebChannelConfig
const position = parsed.position === "left" ? "left" : "right"
return {
title: parsed.title?.trim() || defaultWebChannelConfig.title,
subtitle: parsed.subtitle?.trim() ?? defaultWebChannelConfig.subtitle,
themeColor:
parsed.themeColor?.trim() || defaultWebChannelConfig.themeColor,
position,
width: parsed.width?.trim() || defaultWebChannelConfig.width,
}
} catch {
return defaultWebChannelConfig
}
}
function parseWechatMPChannelConfig(configJson: string): Required<WechatMPChannelConfig> {
const fallback = {
...defaultWebChannelConfig,
title: "公众号客服",
appId: "",
appSecret: "",
oauthScope: "snsapi_base" as const,
oauthEnabled: true,
}
if (!configJson.trim()) {
return fallback
}
try {
const parsed = JSON.parse(configJson) as WechatMPChannelConfig
const base = parseWebChannelConfig(configJson)
const oauthScope =
parsed.oauthScope === "snsapi_userinfo" ? "snsapi_userinfo" : "snsapi_base"
return {
...base,
title: parsed.title?.trim() || fallback.title,
appId: parsed.appId?.trim() || "",
appSecret: parsed.appSecret?.trim() || "",
oauthScope,
oauthEnabled: parsed.oauthEnabled ?? true,
}
} catch {
return fallback
}
}
function buildForm(item: AdminChannel | null): EditForm {
if (!item) {
return emptyForm
}
const isWechatMP = item.channelType === "wechat_mp"
const webConfig = parseWebChannelConfig(item.configJson)
const wechatConfig = isWechatMP
? parseWechatMPChannelConfig(item.configJson)
: null
const widgetConfig = wechatConfig ?? webConfig
return {
channelType:
item.channelType === "wxwork_kf"
? "wxwork_kf"
: item.channelType === "wechat_mp"
? "wechat_mp"
: "web",
aiAgentId: item.aiAgentId > 0 ? String(item.aiAgentId) : "",
name: item.name,
openKfId: parseOpenKfId(item.configJson),
widgetTitle: widgetConfig.title,
widgetSubtitle: widgetConfig.subtitle,
widgetThemeColor: widgetConfig.themeColor,
widgetPosition: widgetConfig.position,
widgetWidth: widgetConfig.width,
wechatAppId: wechatConfig?.appId ?? "",
wechatAppSecret: wechatConfig?.appSecret ?? "",
wechatOAuthScope: wechatConfig?.oauthScope ?? "snsapi_base",
remark: item.remark || "",
}
}
function buildPayload(form: EditForm, status: number): CreateAdminChannelPayload {
const channelType = form.channelType
const webLikeConfig = {
title:
form.widgetTitle.trim() ||
(channelType === "wechat_mp" ? "公众号客服" : defaultWebChannelConfig.title),
subtitle: form.widgetSubtitle.trim(),
themeColor:
form.widgetThemeColor.trim() || defaultWebChannelConfig.themeColor,
position: form.widgetPosition || defaultWebChannelConfig.position,
width: form.widgetWidth.trim() || defaultWebChannelConfig.width,
}
const configJson =
channelType === "wxwork_kf"
? JSON.stringify({ openKfId: form.openKfId.trim() })
: channelType === "wechat_mp"
? JSON.stringify({
...webLikeConfig,
appId: form.wechatAppId.trim(),
appSecret: form.wechatAppSecret.trim(),
oauthScope: form.wechatOAuthScope || "snsapi_base",
oauthEnabled: true,
})
: JSON.stringify(webLikeConfig)
return {
channelType,
aiAgentId: Number(form.aiAgentId),
name: form.name.trim(),
configJson,
status,
remark: form.remark.trim(),
}
}
type ChannelFormBodyProps = Omit<ChannelFormDialogProps, "open">
export function EditDialog({
open,
saving,
itemId,
onOpenChange,
onSubmit,
}: ChannelFormDialogProps) {
if (!open) {
return null
}
return (
<ChannelFormBody
key={itemId ? `edit-${itemId}` : "create"}
itemId={itemId}
saving={saving}
onOpenChange={onOpenChange}
onSubmit={onSubmit}
/>
)
}
function ChannelFormBody({
saving,
itemId,
onOpenChange,
onSubmit,
}: ChannelFormBodyProps) {
const formId = "channel-edit-form"
const [loading, setLoading] = useState(false)
const [aiAgents, setAIAgents] = useState<AIAgent[]>([])
const [wxWorkKFAccounts, setWxWorkKFAccounts] = useState<WxWorkKFAccount[]>([])
const [wxWorkKFAccountsLoading, setWxWorkKFAccountsLoading] = useState(false)
const [wxWorkKFAccountsError, setWxWorkKFAccountsError] = useState("")
const [channelDetail, setChannelDetail] = useState<AdminChannel | null>(null)
const [currentStatus, setCurrentStatus] = useState(0)
const form = useForm<
z.input<typeof schema>,
undefined,
z.output<typeof schema>
>({
resolver,
defaultValues: emptyForm,
})
const {
control,
handleSubmit,
register,
reset,
formState: { errors },
} = form
const channelType = useWatch({ control, name: "channelType" })
const openKfId = useWatch({ control, name: "openKfId" })
const isWebLikeChannel = channelType === "web" || channelType === "wechat_mp"
useEffect(() => {
async function loadAIAgents() {
try {
const data = await fetchAIAgentsAll({ status: 1 })
setAIAgents(data)
} catch (error) {
console.error("Failed to load AI agents:", error)
}
}
void loadAIAgents()
}, [])
useEffect(() => {
async function loadDetail() {
if (!itemId) {
setCurrentStatus(0)
setChannelDetail(null)
reset(emptyForm)
return
}
setLoading(true)
try {
const data = await fetchChannel(itemId)
setChannelDetail(data)
setCurrentStatus(data.status)
reset(buildForm(data))
} catch (error) {
console.error("Failed to load channel:", error)
} finally {
setLoading(false)
}
}
void loadDetail()
}, [itemId, reset])
useEffect(() => {
if (
channelType !== "wxwork_kf" ||
wxWorkKFAccounts.length > 0 ||
wxWorkKFAccountsLoading ||
wxWorkKFAccountsError
) {
return
}
async function loadWxWorkKFAccounts() {
setWxWorkKFAccountsLoading(true)
setWxWorkKFAccountsError("")
try {
const data = await fetchWxWorkKFAccounts()
setWxWorkKFAccounts(data)
} catch (error) {
console.error("Failed to load WeCom KF accounts:", error)
setWxWorkKFAccountsError(
error instanceof Error ? error.message : "企业微信客服账号加载失败"
)
} finally {
setWxWorkKFAccountsLoading(false)
}
}
void loadWxWorkKFAccounts()
}, [
channelType,
wxWorkKFAccounts.length,
wxWorkKFAccountsError,
wxWorkKFAccountsLoading,
])
const aiAgentOptions = aiAgents.map((item) => ({
value: String(item.id),
label: item.name,
}))
const wxWorkKFAccountOptions = wxWorkKFAccounts.map((item) => ({
value: item.openKfId,
label: item.name ? `${item.name} (${item.openKfId})` : item.openKfId,
}))
if (
channelType === "wxwork_kf" &&
openKfId &&
!wxWorkKFAccountOptions.some((item) => item.value === openKfId)
) {
wxWorkKFAccountOptions.unshift({
value: openKfId,
label: openKfId,
})
}
async function onFormSubmit(values: EditForm) {
await onSubmit(buildPayload(values, currentStatus))
}
return (
<ProjectDialog
open={true}
onOpenChange={onOpenChange}
title={itemId ? "编辑渠道" : "新建渠道"}
size="lg"
allowFullscreen
footer={
<>
<Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
取消
</Button>
<Button type="submit" form={formId} disabled={saving || loading}>
{saving ? "保存中..." : "保存"}
</Button>
</>
}
>
{loading ? (
<div className="flex items-center justify-center py-12">
<div className="text-muted-foreground">加载中...</div>
</div>
) : (
<form id={formId} onSubmit={handleSubmit(onFormSubmit)} className="space-y-5">
<div className="grid grid-cols-1 gap-4">
<Field data-invalid={!!errors.name}>
<FieldLabel htmlFor="channel-name">渠道名称</FieldLabel>
<FieldContent>
<Input id="channel-name" {...register("name")} />
<FieldError errors={[errors.name]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.aiAgentId}>
<FieldLabel>接待 Agent</FieldLabel>
<FieldContent>
<Controller
control={control}
name="aiAgentId"
render={({ field }) => (
<OptionCombobox
value={field.value}
options={aiAgentOptions}
placeholder="请选择 AI Agent"
searchPlaceholder="搜索 AI Agent"
emptyText="未找到 AI Agent"
onChange={field.onChange}
/>
)}
/>
<FieldError errors={[errors.aiAgentId]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.channelType}>
<FieldLabel>接入渠道</FieldLabel>
<FieldContent>
<Controller
control={control}
name="channelType"
render={({ field }) => (
<OptionCombobox
value={field.value}
options={[...channelTypeOptions]}
placeholder="请选择接入渠道"
searchPlaceholder="搜索接入渠道"
emptyText="未找到接入渠道"
onChange={field.onChange}
/>
)}
/>
<FieldError errors={[errors.channelType]} />
</FieldContent>
</Field>
</div>
<div className="space-y-4 rounded-md border p-4">
<div>
<div className="text-sm font-medium">渠道配置</div>
<div className="text-xs text-muted-foreground">
{channelType === "wxwork_kf"
? "配置企业微信客服账号,用于匹配回调消息和对外发送消息。"
: channelType === "wechat_mp"
? "配置公众号网页授权和客服窗口展示参数。"
: "配置 Web 站点客服窗口的展示参数。"}
</div>
</div>
{channelType === "wxwork_kf" ? (
<Field data-invalid={!!errors.openKfId}>
<FieldLabel>企业微信客服账号</FieldLabel>
<FieldContent>
<Controller
control={control}
name="openKfId"
render={({ field }) => (
<OptionCombobox
value={field.value}
options={wxWorkKFAccountOptions}
placeholder={
wxWorkKFAccountsLoading ? "正在加载客服账号" : "请选择客服账号"
}
searchPlaceholder="搜索客服账号"
emptyText={
wxWorkKFAccountsError || "未找到企业微信客服账号"
}
disabled={wxWorkKFAccountsLoading}
onChange={field.onChange}
/>
)}
/>
<FieldError errors={[errors.openKfId]} />
</FieldContent>
</Field>
) : null}
{isWebLikeChannel ? (
<>
<div className="grid grid-cols-1 gap-4 sm:grid-cols-2">
{channelType === "wechat_mp" ? (
<>
<Field data-invalid={!!errors.wechatAppId}>
<FieldLabel htmlFor="channel-wechat-app-id">
公众号 AppID
</FieldLabel>
<FieldContent>
<Input
id="channel-wechat-app-id"
{...register("wechatAppId")}
/>
<FieldError errors={[errors.wechatAppId]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.wechatAppSecret}>
<FieldLabel htmlFor="channel-wechat-app-secret">
公众号 AppSecret
</FieldLabel>
<FieldContent>
<Input
id="channel-wechat-app-secret"
type="password"
autoComplete="new-password"
{...register("wechatAppSecret")}
/>
<FieldError errors={[errors.wechatAppSecret]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.wechatOAuthScope}>
<FieldLabel>网页授权方式</FieldLabel>
<FieldContent>
<Controller
control={control}
name="wechatOAuthScope"
render={({ field }) => (
<OptionCombobox
value={field.value}
options={[...oauthScopeOptions]}
placeholder="请选择网页授权方式"
searchPlaceholder="搜索网页授权方式"
emptyText="未找到网页授权方式"
onChange={field.onChange}
/>
)}
/>
<FieldError errors={[errors.wechatOAuthScope]} />
</FieldContent>
</Field>
</>
) : null}
<Field data-invalid={!!errors.widgetTitle}>
<FieldLabel htmlFor="channel-widget-title">窗口标题</FieldLabel>
<FieldContent>
<Input id="channel-widget-title" {...register("widgetTitle")} />
<FieldError errors={[errors.widgetTitle]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.widgetSubtitle}>
<FieldLabel htmlFor="channel-widget-subtitle">窗口副标题</FieldLabel>
<FieldContent>
<Input
id="channel-widget-subtitle"
{...register("widgetSubtitle")}
/>
<FieldError errors={[errors.widgetSubtitle]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.widgetThemeColor}>
<FieldLabel htmlFor="channel-widget-theme-color">主题色</FieldLabel>
<FieldContent>
<Input
id="channel-widget-theme-color"
placeholder="#2563eb"
{...register("widgetThemeColor")}
/>
<FieldError errors={[errors.widgetThemeColor]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.widgetPosition}>
<FieldLabel>挂载位置</FieldLabel>
<FieldContent>
<Controller
control={control}
name="widgetPosition"
render={({ field }) => (
<OptionCombobox
value={field.value}
options={[...widgetPositionOptions]}
placeholder="请选择挂载位置"
searchPlaceholder="搜索挂载位置"
emptyText="未找到挂载位置"
onChange={field.onChange}
/>
)}
/>
<FieldError errors={[errors.widgetPosition]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.widgetWidth}>
<FieldLabel htmlFor="channel-widget-width">窗口宽度</FieldLabel>
<FieldContent>
<Input
id="channel-widget-width"
placeholder="380px"
{...register("widgetWidth")}
/>
<FieldError errors={[errors.widgetWidth]} />
</FieldContent>
</Field>
</div>
<WebAccessGuide
channelId={channelDetail?.channelId || ""}
channelType={channelType === "wechat_mp" ? "wechat_mp" : "web"}
/>
</>
) : null}
</div>
<Field data-invalid={!!errors.remark}>
<FieldLabel htmlFor="channel-remark">备注</FieldLabel>
<FieldContent>
<Textarea id="channel-remark" rows={3} {...register("remark")} />
<FieldError errors={[errors.remark]} />
</FieldContent>
</Field>
</form>
)}
</ProjectDialog>
)
}
function WebAccessGuide({
channelId,
channelType,
}: {
channelId: string
channelType: "web" | "wechat_mp"
}) {
const [origin, setOrigin] = useState("")
const isWechatMP = channelType === "wechat_mp"
useEffect(() => {
setOrigin(window.location.origin)
}, [])
const accessUrl = useMemo(() => {
if (!origin || !channelId) {
return ""
}
const url = new URL(
isWechatMP ? "/api/channel/wechat_mp/oauth/authorize" : "/kefu/chat/",
origin
)
url.searchParams.set("channelId", channelId)
if (isWechatMP) {
url.searchParams.set("returnPath", "/kefu/chat/")
}
return url.toString()
}, [channelId, isWechatMP, origin])
const testUrl = useMemo(() => {
if (!origin || !channelId) {
return ""
}
const url = new URL("/kefu", origin)
url.searchParams.set("channelId", channelId)
return url.toString()
}, [channelId, origin])
const snippet = useMemo(() => {
if (!origin || !channelId) {
return ""
}
return `<script>
window.CSAgentConfig = {
channelId: "${channelId}"${isWechatMP ? ',\n externalSource: "wechat_mp"' : ""}
};
</script>
<script async src="${origin}/sdk/cs-ai-agent-sdk.min.js"></script>`
}, [channelId, isWechatMP, origin])
async function copyText(text: string, successMessage: string) {
if (!text) {
return
}
try {
await navigator.clipboard.writeText(text)
toast.success(successMessage)
} catch {
toast.error("复制失败")
}
}
return (
<div className="space-y-4 border-t pt-4">
<div>
<div className="text-sm font-medium">
{isWechatMP ? "微信公众号接入信息" : "Web 接入信息"}
</div>
<div className="text-xs text-muted-foreground">
{channelId
? isWechatMP
? "将授权链接配置到公众号菜单,用户授权后会进入客服窗口。"
: "复制链接或嵌入代码即可接入当前 Web 渠道。"
: "保存渠道后生成接入链接。"}
</div>
</div>
{!channelId ? (
<div className="rounded-md bg-muted px-3 py-2 text-sm text-muted-foreground">
当前为新建渠道,保存后会生成 channelId
</div>
) : (
<div className="space-y-4">
<div className="space-y-2">
<div className="text-xs font-medium text-muted-foreground">
{isWechatMP ? "公众号菜单授权链接" : "直接访问链接"}
</div>
<div className="flex flex-col gap-2 sm:flex-row">
<Input readOnly value={accessUrl} className="font-mono text-xs" />
<div className="flex gap-2">
<Button
type="button"
variant="outline"
size="icon"
title="复制链接"
onClick={() => copyText(accessUrl, "已复制接入链接")}
>
<CopyIcon className="size-4" />
</Button>
<Button
type="button"
variant="outline"
size="icon"
title="打开链接"
onClick={() => window.open(accessUrl, "_blank", "noopener,noreferrer")}
>
<ExternalLinkIcon className="size-4" />
</Button>
</div>
</div>
</div>
{!isWechatMP ? (
<div className="space-y-2">
<div className="flex items-center justify-between gap-2">
<div className="text-xs font-medium text-muted-foreground">
嵌入式接入代码
</div>
<Button
type="button"
variant="outline"
size="sm"
onClick={() => copyText(snippet, "已复制接入代码")}
>
<CopyIcon className="size-4" />
复制代码
</Button>
</div>
<pre className="max-h-48 overflow-auto rounded-md bg-muted p-3 text-xs leading-5">
<code>{snippet}</code>
</pre>
</div>
) : null}
<div className="flex flex-col gap-2 rounded-md bg-muted px-3 py-3 text-xs text-muted-foreground">
<div className="font-medium text-foreground">接入教程</div>
{isWechatMP ? (
<>
<div>1. 确认该渠道已启用,并在微信公众平台配置网页授权域名。</div>
<div>2. 将公众号菜单跳转地址设置为上方授权链接。</div>
<div>3. 用户点击菜单并授权后,会以 openid 作为稳定客户身份进入客服窗口。</div>
</>
) : (
<>
<div>1. 确认该渠道已启用。</div>
<div>2. 将嵌入代码粘贴到目标网站 HTML body 结束标签前。</div>
<div>3. 发布网站后刷新页面,客服入口会按渠道配置展示。</div>
<div>4. 独立页面或二维码场景可直接使用访问链接。</div>
<div className="pt-1">
<Button
type="button"
variant="outline"
size="sm"
onClick={() => window.open(testUrl, "_blank", "noopener,noreferrer")}
>
<ExternalLinkIcon className="size-4" />
打开测试页
</Button>
</div>
</>
)}
</div>
</div>
)}
</div>
)
}