SlackNet .NET Library

The Examples directory provides several project templates demonstrating how to integrate SlackNet with different frameworks and dependency injection (DI) containers. Use these as starting points for your own implementation:

• SlackNetDemo: The primary example project demonstrating general Slack app capabilities. It also serves as the reference for integrating with Microsoft.Extensions.DependencyInjection.
• AspNetCoreExample: Demonstrates integrating SlackNet with ASP.NET Core.
• AzureFunctionsExample: Demonstrates integrating SlackNet with Azure Functions.
• AutofacExample: Demonstrates integrating SlackNet with the Autofac DI container.
• SimpleInjectorExample: Demonstrates integrating SlackNet with the Simple Injector DI container.
• NoContainerExample: Demonstrates how to use SlackNet in environments without a DI container.

While using a dependency injection container is recommended for most scenarios, SlackNet provides a SlackServiceBuilder for scenarios where you want to manage services manually via a basic service factory.

Important: All configuration must be performed on the builder before calling the method to create the service. Any configuration attempted after the service has been created may not have any effect.

Socket Mode allows your application to receive events from Slack without needing a public URL. To use it, initialize the client using an App-Level OAuth token via SlackServiceBuilder. You must register event handlers during the build process.

    .UseAppLevelToken("<app-level OAuth token required for socket mode>")
    /* Register handlers here */
    .GetSocketModeClient();

await client.Connect();

To receive Slack requests in an ASP.NET Core application, register SlackNet in your service container and add the middleware to your request pipeline. You must provide both an API token and a signing secret for security.

    .UseApiToken("<your bot or user OAuth token here>")
    .UseSigningSecret("<your signing secret here>"));

var app = builder.Build();
app.UseSlackNet();

To use SlackNet.Bot, add the SlackNet.Bot NuGet package to your project. You connect the bot by instantiating a SlackBot with your bot token and calling Connect().

Note: SlackNet.Bot uses Slack's Real Time Messaging (RTM) API. For most modern applications, the Socket Mode client is recommended, as Slack has deprecated the RTM API and it requires a classic app with a V1 OAuth flow.

await bot.Connect();

SlackNet services can be integrated with Autofac using an API similar to other SlackNet configuration scenarios.

Important Registration Rules:

• All Slack handlers must be registered inside the AddSlackNet method.
• Handlers are scoped per Slack request.
• You can override these registrations using standard Autofac API methods after the initial registration.

Depending on your integration requirements, choose one of the following NuGet packages:

• SlackNet: The core package. Provides a comprehensive Slack API client and a Socket Mode client for receiving events.
• SlackNet.AspNetCore: Integration for ASP.NET Core applications to receive requests from Slack via HTTP.
• SlackNet.AzureFunctions: Integration for Azure Functions to receive requests from Slack.

Note: A SlackNet.Bot package exists for the deprecated RTM API, but using the Socket Mode client is recommended.

SlackNet.AzureFunctions requires ASP.NET Core integration for the Azure Functions isolated process.

1. Copy the SlackEndpoints.cs class (available in the project examples) into your project to provide the functions Slack calls.
2. Configure the host builder to use SlackNet.
3. Register SlackNet services with your API token and signing secret.

Warning: Early responses are not supported in Azure Functions; ensure you complete request handling promptly.

hostBuilder.ConfigureServices(services => services
    .AddSlackNet(c => c
        .UseApiToken("<your bot or user OAuth token here>")
        .UseSigningSecret("<your signing secret here>")));