Bitzsoft.Integrations.OutboundCall.Tencent 1.0.0-alpha.6

Bitzsoft.Integrations.OutboundCall.Tencent

腾讯云外呼实现 — 基于 CCC SDK，实现 IOutboundCallService 统一接口。

功能

• 实现 IOutboundCallService 统一接口（创建/暂停/恢复/停止/查询活动 + 话单查询）
• 自动境内外主叫分离（基于 CreateCampaignRequest.Region 选择 Callers/OverseaCallers + SdkAppId + IvrId）
• 白名单/黑名单过滤（开发/测试环境防误呼）
• 底层直接引用官方 TencentCloudSDK.Common，内联仅外呼场景的瘦客户端（自动外呼任务 / 预测式外呼 Campaign / 话单查询），无独立 TencentCcc 包依赖

安装

dotnet add package Bitzsoft.Integrations.OutboundCall.Tencent

配置

{
  "OutboundCall": {
    "AccessKeyId": "your-secret-id",
    "AccessKeySecret": "your-secret-key",
    "Region": "ap-guangzhou",
    "SdkAppId": "1400818883",
    "OverseaSdkAppId": "1400818885",
    "CnIvrId": 21232,
    "EnIvrId": 21408,
    "Callers": ["008602160662606"],
    "OverseaCallers": ["0085230087235"]
  }
}

注册

services.AddTencentOutboundCall(options =>
{
    options.AccessKeyId = "your-secret-id";
    options.AccessKeySecret = "your-secret-key";
    options.Region = "ap-guangzhou";
    options.SdkAppId = "1400818883";
    options.Callers = new() { "008602160662606" };
    options.OverseaCallers = new() { "0085230087235" };
});

第三方请求日志

⚠️ 机制说明：本连接器基于 TencentCloudSDK.Common（AbstractClient），HTTP 管道封装在 SDK 内部，无法用 DelegatingHandler 拦截（与阿里云/华为云/火山引擎/容联云的 HttpClient 实现不同）。因此请求日志改由 IRequestLogRecorder 回调钩子实现——在 TencentCccOutboundClient.ExecuteAsync 包装层记录每次 API 调用，汇入与 HttpClient 拦截同一个日志管道（IRequestLogStore），由宿主统一持久化。

记录内容（每次外呼 API 调用产生一条）：

局限（诚实声明）：

• SDK 不暴露原始 HTTP 状态码与响应头，故无法像 HttpClient 拦截那样记录真实 HTTP StatusCode/RequestHeaders，StatusCode 仅为尽力而为（成功记 200、异常时留空）。
• 仅本连接器实现的 7 个外呼相关动作会被记录；腾讯 CCC 的其他能力（坐席/技能组/分机/会话/IM 等）本连接器未实现，不在记录范围。

// ① 默认：启用回调但不持久化（日志丢弃）
services.AddTencentOutboundCall(options => { /* ... */ });

// ② 持久化：宿主注册 IRequestLogStore 实现后，腾讯外呼调用自动落库
//    AddTencentOutboundCall 内部已注入 IRequestLogRecorder，宿主无需再额外挂载 handler
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxBodyLength = 0;               // 腾讯响应（如话单列表）可能很长，0=不截断完整保留
    opts.SensitiveFields.Add("SdkAppId"); // 额外脱敏字段
});
services.AddTencentOutboundCall(options => { /* ... */ });

自定义 IRequestLogStore 实现（SqlSugar / Dapper / MongoDB）详见 Bitzsoft.Integrations.RequestLogging。

使用

// 号码清洗 + 分类
var (mainland, oversea) = PhoneNumberClassifier.Classify(rawPhones);

// 境内外呼
await outboundCall.CreateCampaignAsync(new CreateCampaignRequest
{
    Name = "催办-境内",
    Region = PhoneRegion.Mainland,
    Callees = mainland
});

// 境外外呼
await outboundCall.CreateCampaignAsync(new CreateCampaignRequest
{
    Name = "催办-境外",
    Region = PhoneRegion.Overseas,
    Callees = oversea
});