Bitzsoft.Integrations.OutboundCall.All 1.0.0

Bitzsoft.Integrations.OutboundCall.All

外呼服务聚合包 — 一次性引用全部供应商实现（腾讯云 / 阿里云 / 火山引擎 / 容联云 / 华为云 / Twilio / Vonage），无需逐个安装。

功能特性

• 聚合 7 家外呼实现：腾讯云 / 阿里云 / 火山引擎 / 容联云 / 华为云 5 家国内 + Twilio / Vonage 2 家国际，全部实现 IOutboundCallService 统一接口
• 统一抽象：引用本包即获得所有 IOutboundCallService 供应商实现及号码工具（PhoneNumberValidator / PhoneNumberClassifier / CallListFilter）
• per-call 编排：国际供应商（Twilio / Vonage）采用共享 CampaignDialer 引擎，按 CPS 节流逐通发起外呼，支持暂停 / 恢复断点
• 零代码即装即用：聚合包为空程序集（仅打包占位 _._ 文件），所有类型由依赖的供应商包提供，安装后按需调用各供应商的 Add*OutboundCall 扩展方法

注意：国际供应商（Twilio / Vonage）的活动编排状态保存在内存中，进程重启会丢失进行中的活动进度，需外部系统重新触发。

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.OutboundCall.All

PackageReference

<PackageReference Include="Bitzsoft.Integrations.OutboundCall.All" Version="1.0.0" />

配置

聚合包本身不含配置，配置由所选供应商实现包决定。各供应商配置节示例：

{
  "OutboundCall": {
    "AccessKeyId": "your-secret-id",
    "AccessKeySecret": "your-secret-key",
    "Region": "ap-guangzhou",
    "SdkAppId": "1400818883",
    "Callers": [ "008602160662606" ],
    "OverseaCallers": [ "0085230087235" ],
    "Whitelist": [ "5678" ],
    "RequireWhitelistInNonProduction": true
  },
  "TwilioOutboundCall": {
    "AccountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "AuthToken": "your-auth-token",
    "From": "+12025550123",
    "Cps": 1
  }
}

各供应商的配置项细节请参阅对应实现包的 README（见「相关包」）。通用字段（AccessKeyId / AccessKeySecret / Region / SdkAppId / Callers 等）见抽象层 OutboundCallOptions。

注册服务

聚合包不含 Add* 扩展方法，按需调用各供应商的注册扩展方法（一次运行通常只注册一家作为 IOutboundCallService）：

using Bitzsoft.Integrations.OutboundCall;
// 命名空间 Microsoft.Extensions.DependencyInjection

// 腾讯云
builder.Services.AddTencentOutboundCall(
    builder.Configuration.GetSection("OutboundCall"));

// 或阿里云
builder.Services.AddAliyunOutboundCall(
    builder.Configuration.GetSection("OutboundCall"));

// 或华为云 / 火山引擎 / 容联云（均绑定 OutboundCall 节）
// builder.Services.AddHuaweiOutboundCall(...);
// builder.Services.AddVolcengineOutboundCall(...);
// builder.Services.AddYuntongxunOutboundCall(...);

// 或国际 Twilio（绑定 TwilioOutboundCall 节）
// builder.Services.AddTwilioOutboundCall(
//     builder.Configuration.GetSection("TwilioOutboundCall"));

说明：IOutboundCallService 注册为单例，同一进程内通常只注册一家供应商。若需多供应商并存，可分别注入各供应商的具体服务类型（如 TencentOutboundCallService）或使用工厂模式按需解析。

使用示例

using Bitzsoft.Integrations.OutboundCall;
using Bitzsoft.Integrations.OutboundCall.Dtos;
using Bitzsoft.Integrations.OutboundCall.PhoneNumber;

public class OutboundCallApp
{
    private readonly IOutboundCallService _outbound;

    public OutboundCallApp(IOutboundCallService outbound) => _outbound = outbound;

    public async Task RunAsync(string[] rawPhones)
    {
        // 1. 号码清洗 + 分类（抽象层提供，所有供应商通用）
        var (mainland, oversea) = PhoneNumberClassifier.Classify(rawPhones);

        // 2. 创建境内活动（实际调用哪家供应商由注册时决定）
        var resp = await _outbound.CreateCampaignAsync(new CreateCampaignRequest
        {
            Name = "催办",
            Region = PhoneRegion.Mainland,
            Callees = mainland.ToList()
        });

        // 3. 查询活动与话单
        var campaigns = await _outbound.ListCampaignsAsync(pageIndex: 1, pageSize: 20);
        var records = await _outbound.QueryCallRecordsAsync(new QueryCallRecordsRequest { PageSize = 50 });
    }
}

请求审计

所有供应商实现均内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认使用 NullRequestLogStore 不持久化。

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

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("AccessKeySecret"); // 额外脱敏字段
});
services.AddTencentOutboundCall(options => { /* ... */ });

依赖

相关包

• Bitzsoft.Integrations.OutboundCall -- 抽象层（接口 + 号码工具 + 白名单）
• Bitzsoft.Integrations.OutboundCall.Tencent -- 腾讯云 CCC
• Bitzsoft.Integrations.OutboundCall.Aliyun -- 阿里云 CCC
• Bitzsoft.Integrations.OutboundCall.Volcengine -- 火山引擎智能外呼
• Bitzsoft.Integrations.OutboundCall.Yuntongxun -- 容联云通讯
• Bitzsoft.Integrations.OutboundCall.Huawei -- 华为云 CEC
• Bitzsoft.Integrations.OutboundCall.Twilio -- 国际 Twilio（per-call 编排）
• Bitzsoft.Integrations.OutboundCall.Vonage -- 国际 Vonage（per-call 编排）