NickSoftware.Switchboard 0.1.0-preview.52

Switchboard - Amazon Connect Infrastructure Framework

A code-first, type-safe .NET framework for building Amazon Connect contact centers using AWS CDK.

⚠️ PREVIEW RELEASE: APIs may change before stable release. Use with caution in production environments.

Overview

Switchboard provides a modern, fluent API for defining Amazon Connect resources as code. Built on .NET 10 and AWS CDK, it eliminates the need for manual console configuration and enables version-controlled, testable contact center infrastructure.

Features

• Fluent API - Intuitive, chainable methods for building contact flows
• Type-Safe - Full IntelliSense support with compile-time validation
• AWS CDK Integration - Deploy directly to AWS with infrastructure as code
• Middleware Pipeline - Extensible validation and logging
• Multi-Language Support - Built-in translation dictionaries for prompts
• Comprehensive Flow Blocks - All Amazon Connect actions supported

Installation

dotnet add package NickSoftware.Switchboard --prerelease

Optional Packages

# Roslyn analyzers for compile-time validation
dotnet add package NickSoftware.Switchboard.Analyzers --prerelease

# Source generators for attribute-based flows
dotnet add package NickSoftware.Switchboard.SourceGenerators --prerelease

# Dependency injection extensions
dotnet add package NickSoftware.Switchboard.Extensions.DependencyInjection --prerelease

Quick Start

using Switchboard;

var app = new SwitchboardApp();
var stack = app.CreateStack("MyCallCenter", "MyConnectInstance");

// Create a contact flow
var flow = Flow.Create("MainFlow")
    .PlayPrompt("Thank you for calling. How can I help you today?")
    .GetCustomerInput("Press 1 for sales, 2 for support", input =>
    {
        input.MaxDigits = 1;
        input.TimeoutSeconds = 5;
    })
        .OnPressed("1", b => b.TransferToQueue("Sales").Disconnect())
        .OnPressed("2", b => b.TransferToQueue("Support").Disconnect())
        .OnTimeout(b => b.PlayPrompt("We didn't receive your input.").Disconnect())
        .OnDefault(b => b.PlayPrompt("Invalid option.").Disconnect())
    .Disconnect()
    .Build();

stack.AddFlow(flow);
app.Synth();

Supported Flow Actions

Interact

• PlayPrompt() - Play text, SSML, or audio prompts
• GetCustomerInput() - Collect DTMF or voice input
• StoreCustomerInput() - Securely store sensitive input

Integrate

• InvokeLambda() - Call AWS Lambda functions
• TransferToFlow() - Transfer to another contact flow

Set

• SetContactAttributes() - Set custom contact attributes
• SetRecordingBehavior() - Enable/disable call recording
• SetLoggingBehavior() - Configure flow logging
• SetWorkingQueue() - Set the working queue
• SetWhisperFlow() - Configure whisper flows

Check

• CheckHoursOfOperation() - Branch based on business hours
• CheckStaffing() - Check agent availability
• CheckContactAttribute() - Conditional routing based on attributes

Logic

• Loop() - Retry logic with configurable attempts

Terminate

• TransferToQueue() - Transfer to a queue
• Disconnect() - End the contact
• EndFlowExecution() - End flow execution

Advanced Features

Lambda Integration with Response Handling

builder.InvokeLambda(myLambda.FunctionArn, "CustomerLookup")
    .OnSuccess(b => b
        .SetContactAttributes(attrs => attrs["CustomerTier"] = "$.External.tier"))
    .OnError(b => b
        .PlayPrompt("We're experiencing technical difficulties.")
        .TransferToQueue("Support"));

Hours of Operation Checks

builder.CheckHoursOfOperation("BusinessHours")
    .WhenInHours(b => b.TransferToQueue("Sales"))
    .WhenOutOfHours(b => b
        .PlayPrompt("We're currently closed. Please call back during business hours.")
        .Disconnect());

Dependency Injection

var builder = Host.CreateApplicationBuilder(args);

builder.Services.AddSwitchboard(options =>
{
    options.InstanceName = "MyCallCenter";
})
.UseMiddleware<LoggingMiddleware>()
.UseMiddleware<ValidationMiddleware>()
.AddAssemblyScanning(typeof(Program).Assembly);

Flow Types

Switchboard supports all Amazon Connect flow types:

• Contact Flow
• Customer Queue Flow
• Customer Hold Flow
• Customer Whisper Flow
• Agent Hold Flow
• Agent Whisper Flow
• Outbound Whisper Flow
• Agent Transfer Flow
• Queue Transfer Flow

Documentation

• 📖 Full Documentation
• 📂 Examples
• 🐛 Report Issues

Requirements

• .NET 10 SDK
• AWS CDK CLI (npm install -g aws-cdk)
• AWS CLI configured with credentials

License

See LICENSE for details.

Built with ❤️ for Amazon Connect developers