ForcePilot/backend/package/yuxi/channel/extensions/wechat-mp/template.py
Kris 87a8931db3 feat(channel): 添加微信客服、微信公众号和微信支付通知渠道扩展
新增微信客服、微信公众号、微信支付通知三个渠道扩展。

微信客服渠道扩展功能模块:
- account: 账户管理
- config: 渠道配置管理
- gateway: SSE/WebSocket 网关接入
- webhook: Webhook 事件处理
- outbound: 外发消息管理
- streaming: 流式消息处理
- pairing: 用户配对与绑定
- security: 安全校验
- crypto: 加解密处理
- dedupe: 消息去重
- customer: 客户管理
- servicer: 客服管理
- session: 会话管理
- status: 会话状态管理
- media: 媒体资源处理
- statistics: 统计功能
- sync: 数据同步
- upgrade: 升级处理

微信公众号渠道扩展功能模块:
- config: 渠道配置管理
- gateway: SSE/WebSocket 网关接入
- webhook: Webhook 事件处理
- outbound: 外发消息管理
- streaming: 流式消息处理
- pairing: 用户配对与绑定
- security: 安全校验
- crypto: 加解密处理
- dedupe: 消息去重
- passive_reply: 被动回复
- message: 消息处理
- broadcast: 群发消息
- template: 模板消息
- menu: 菜单管理
- qrcode: 二维码管理
- user: 用户管理
- media: 媒体资源处理
- status: 会话状态管理

微信支付通知渠道扩展功能模块:
- config: 渠道配置管理
- webhook: Webhook 事件处理
- crypto: 加解密与签名校验
- cert_manager: 证书管理
- event_router: 事件路由
- dedupe: 消息去重
- pay_repo: 支付数据仓库
- query_client: 查询客户端
- arq_tasks: 异步任务
- callback_compensator: 回调补偿
2026-05-21 12:00:30 +08:00

99 lines
3.1 KiB
Python

import logging
import httpx
logger = logging.getLogger(__name__)
TEMPLATE_SEND_URL = "https://api.weixin.qq.com/cgi-bin/message/template/send"
TEMPLATE_LIST_URL = "https://api.weixin.qq.com/cgi-bin/template/get_all_private_template"
SUBSCRIBE_SEND_URL = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send"
class WeChatTemplate:
def __init__(self, gateway):
self._gateway = gateway
async def send(
self,
to_user: str,
template_id: str,
data: dict,
url: str = "",
miniprogram: dict | None = None,
) -> bool:
token = self._gateway.access_token if self._gateway else None
if not token:
return False
payload = {
"touser": to_user,
"template_id": template_id,
"data": {k: {"value": v} for k, v in data.items()},
}
if url:
payload["url"] = url
if miniprogram:
payload["miniprogram"] = miniprogram
try:
async with httpx.AsyncClient(timeout=10.0) as client:
resp = await client.post(f"{TEMPLATE_SEND_URL}?access_token={token}", json=payload)
result = resp.json()
return result.get("errcode") == 0
except Exception:
logger.exception("Send template message exception")
return False
async def list_templates(self) -> list[dict]:
token = self._gateway.access_token if self._gateway else None
if not token:
return []
try:
async with httpx.AsyncClient(timeout=10.0) as client:
resp = await client.get(f"{TEMPLATE_LIST_URL}?access_token={token}")
data = resp.json()
if "template_list" in data:
return data["template_list"]
logger.warning(
"List templates failed: errcode=%s errmsg=%s",
data.get("errcode"),
data.get("errmsg"),
)
except Exception:
logger.exception("List templates exception")
return []
async def send_subscribe(
self,
to_user: str,
template_id: str,
data: dict,
page: str = "",
miniprogram_state: str = "formal",
lang: str = "zh_CN",
) -> bool:
token = self._gateway.access_token if self._gateway else None
if not token:
return False
payload = {
"touser": to_user,
"template_id": template_id,
"data": {k: {"value": v} for k, v in data.items()},
"miniprogram_state": miniprogram_state,
"lang": lang,
}
if page:
payload["page"] = page
try:
async with httpx.AsyncClient(timeout=10.0) as client:
resp = await client.post(f"{SUBSCRIBE_SEND_URL}?access_token={token}", json=payload)
result = resp.json()
return result.get("errcode") == 0
except Exception:
logger.exception("Send subscribe message exception")
return False