Table of Contents

Slack Channel Configuration

Below are the necessary steps to configure the Slack channel and connect it with Lynn. Through this integration, you can enable message reception and delivery between a Slack workspace and the Lynn platform, allowing you to manage interactions directly from this collaboration tool. The setup includes configuration on both Slack and the Lynn channel administration platform.

Prerequisites

  • You must have a Slack workspace (an active account is required).

  • Create a new app in Slack from Slack API: Applications | Slack.

    1. You can add more than one app to the same workspace if needed.
    2. Accept the terms and conditions of the Slack Marketplace.

    Create app in Slack workspace

    1. When creating a new app, you can start from scratch or use a configuration manifest.

    In this case, select the From scratch option to create it from the beginning:

    Select app creation method: from manifest or from scratch

    Enter the app details:

    Form to set app name and select workspace Form to set app name and select workspace

    1. Once created, the interface will display the app credentials. Copy the following values (do not share them with third parties):
    • Client ID
    • Client Secret
    • Signing Secret
    • Verification Token

    Fields with client ID, client secret, and verification token

    1. Customize your bot or channel information in Slack. Scroll down in the same interface and complete the description, image, and optionally an extended description.

    Fields to complete Slack Marketplace information

Steps to Create the Channel

  1. Log in to Lynn.
  2. Select the Designer option from the main menu.
  3. Right-click on a blank area of the designer.

Context menu to add channel in Lynn designer

A context menu will appear.

  1. Select Configure Channel and then Add Channel to [Environment].
  2. Choose Slack from the list of available channels in Lynn.

Channel list in Lynn

  1. Click Create.

A window will appear with the required fields to configure the channel.

Channel configuration fields

Other required channel configuration fields

To complete this information, copy the values obtained from the Slack app configuration interface and paste them into Lynn's channel configurator. See the Prerequisites section for more details.

  1. Click the Verify button to start the parameter validation process. Then, click Create.

A confirmation pop-up will appear indicating the channel was successfully created.

  1. Activate the channel: right-click on the bubble of the created channel. A context menu will appear. Select Activate. The channel will change to a solid white color, indicating it is active.

  2. Authorize the channel: once the channel is active, right-click it again to access the contextual menu. Select Authorize.

Slack channel context menu options

You will be redirected in a new tab to the Slack API web interface. If you're authenticated, the permissions request screen will appear.

Slack permissions request screen

  1. If you agree to grant permissions, click the Allow button.

Additional Configuration in Slack

  1. When the channel is created in Lynn, it provides two important values: the redirect URL and the subscription URL. Copy these values and enter them into your app's configuration interface in Slack.

    Redirect and event subscription URLs

    To add the redirect URL:

    • Go to the OAuth & Permissions section in your Slack app settings.

    • Add the URLs provided by Lynn in the appropriate fields.

    • Save the changes.

      Fields in Slack API to set redirect URLs

    To configure the subscription URL:

    • Go to the Event Subscriptions section.

    • Enable event subscriptions.

    • Add the subscription URL provided by Lynn in the appropriate field.

    • Select the events you want your bot to listen to.

      Recommended subscription events for the bot:

      member_joined_channel
      member_left_channel
      message.channels
      message.groups
      message.im
      message.mpim

      Event Subscriptions section

    • Make sure to select the appropriate scope for each event (usually the first option shown).

    • Save the changes.

  2. In the App Home section, enable users to send messages:

    1. Turn on the Show tabs option and make sure the Messages tab is visible.
    2. Toggle the switch to green to enable it.
    3. If your app requires commands, also enable the corresponding option. (By default, Lynn bots do not require this functionality).

  3. Install the app in Slack:

    In your app's configuration panel in Slack:

    1. Open the Install App section.
    2. Click the Install App to [Workspace] button to install the app in your workspace.
    3. Authorize the app in your workspace.

    Install Slack app