Retrieve Information from Microsoft Teams

To automatically retrieve content from Microsoft Teams, create a new fetch task by following these steps. The connector runs each fetch task automatically, based on the schedule that is defined 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. Ensure that the relevant OAuth parameters are included in the configuration file. For example, the following line imports the relevant parameters from a file named oauth.cfg. This file is generated by the OAuth configuration tool that is supplied with the connector (see Install Microsoft Teams Connector).

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

    For more information about importing parameters into a configuration file, see Include an External Configuration File.

  2. (Optional) If a proxy server is required to access the repository, set the following parameters.

    ProxyHost The host name or IP address of the proxy server.
    ProxyPort The port of the proxy server.
    ProxyUsername (Optional) The user name to use to authenticate with the proxy server.
    ProxyPassword (Optional) The password to use to authenticate with the proxy server.
  3. (Optional) You can set the following parameters to specify what to synchronize:

    TeamCantHaveRegex A regular expression to restrict the teams that are synchronized by the connector. If the display name of a team matches the regular expression, it is ignored.
    TeamMustHaveRegex A regular expression to restrict the teams that are synchronized by the connector. The display name of a team must match the regular expression, otherwise it is ignored.
    ChannelCantHaveRegex A regular expression to restrict the channels that are synchronized by the connector. If the name of a channel matches the regular expression, it is ignored.
    ChannelMustHaveRegex A regular expression to restrict the channels that are synchronized by the connector. The name of a channel must match the regular expression, otherwise it is ignored.
    IndexUserChats

    A Boolean value that specifies whether to synchronize one-to-one and group messages for each user.

    NOTE: To use this feature you must have an appropriate Microsoft 365 license that allows you to use the chats: getAllMessages endpoint. This might require payment to Microsoft (see the Microsoft documentation and use the parameter ModelLicense to specify your license model). You must also have a service application that satisfies the Teams Export APIs prerequisites at https://learn.microsoft.com/en-us/microsoftteams/export-teams-content. For information about setting up a service application, see Set up an OAuth Service Application.

    IndexAttachments A Boolean value that specifies whether to index attachments and hosted content as IDOL documents. By default, attachments and hosted content are ignored.
  4. Save and close the configuration file.