Retrieve Information from Slack

To retrieve information from Slack, create a new fetch task by following these steps. The connector runs fetch tasks automatically, based on the schedule that is configured in the configuration file.

To create a new Fetch Task

  1. Stop the connector.
  2. Open the configuration file in a text editor.
  3. In the [FetchTasks] section of the configuration file, specify the number of fetch tasks using the Number parameter. If you are configuring the first fetch task, type Number=1. If one or more fetch tasks have already been configured, increase the value of the Number parameter by one (1). Below the Number parameter, specify the names of the fetch tasks, starting from zero (0). For example:

    [FetchTasks]
    Number=1
    0=MyTask
  4. Below the [FetchTasks] section, create a new TaskName section. The name of the section must match the name of the new fetch task. For example:

    [FetchTasks]
    Number=1
    0=MyTask
    
    [MyTask]
  1. In the new section, ensure that you have set the parameters required to authenticate with Slack. The OAuth configuration tool (described in Configure OAuth Authentication) creates a file that contains these parameters, and you can include them in the connector's configuration file using the following syntax:

    [MyTask] < "oauth.cfg" [OAUTH]

    For more information about including parameters from another file, see Include an External Configuration File

  2. In the new section, set the following configuration parameters:

    ProxyHost (Optional) The host name or IP address of the proxy server to use to access Slack.
    ProxyPort (Optional) The port of the proxy server to use to access Slack.
    SSLMethod The version of SSL/TLS to use when communicating with Slack.
    ProcessChannels (Optional, default true). A Boolean value that specifies whether to retrieve content (messages, attachments, and files) from Slack channels.
    ChannelNameMustHaveRegex (Optional) A regular expression to limit the channels that are processed by the connector. The full name of a channel must match the regular expression, otherwise the connector does not retrieve any information from the channel.
    ChannelNameCantHaveRegex (Optional) A regular expression to limit the channels that are processed by the connector. If the full name of a channel matches the regular expression, the connector does not retrieve any information from the channel.
    ProcessGroups (Optional, default true). A Boolean value that specifies whether to retrieve content (messages, attachments, and files) from Slack private channels.
    ProcessIMs (Optional, default true). A Boolean value that specifies whether to retrieve content (messages, attachments, and files) from Slack direct message channels.
    ProcessMPIMs (Optional, default true). A Boolean value that specifies whether to retrieve content (messages, attachments, and files) from Slack multi-person direct message (group message) channels.

    For example:

    [MyTask] < "oauth.cfg" [OAUTH]
    ProxyHost=proxy
    ProxyPort=8080
    SSLMethod=NEGOTIATE
    ProcessChannels=TRUE
    ChannelNameMustHaveRegex=development|idol.*
    ProcessGroups=TRUE
    ProcessIMs=FALSE
    ProcessMPIMs=TRUE

    For a complete list of the configuration parameters that you can use to configure the connector and customize the information that is synchronized, refer to the Slack Connector Reference.

  3. Save and close the configuration file.