# GroupMessagesByInterval

Set this parameter to group multiple messages (from the same channel) into a single IDOL document. For example, if you set `GroupMessagesByInterval=5 minutes`, the connector groups messages that occur within a five-minute interval.

The next interval begins at the time of the first message that falls outside the preceding interval. For example, notice the one minute gap between the following five-minute intervals:

    10:30 - Message1      [Interval 1 starts at 10:30]
    10:32 - Message2      [In interval 1]
    10:34 - Message3      [In interval 1]
                          [Interval 1 ends at 10:35]
    10:36 - Message4      [Interval 2 starts at 10:36]
    10:38 - Message5      [In interval 2]
    10:40 - Message6      [In interval 2]

If you set this parameter and also set GroupMessagesByCount, the connector starts a new document as soon as one of the criteria (time interval or number of messages) is reached.

Type: | Time duration The value of this parameter is a time duration. Specify a value using one or more of the following units:
         years      y
         months     m
         weeks      w
         days       d
         hours      h
         minutes    n
         seconds    s
Note that months abbreviates to m, minutes to n. If you want to specify the value in seconds, units are not required. For example, all of the following are equivalent:
         1minute 3seconds
         1n 3s
         63s
         63
Default: |
Required: | No
Configuration Section: | TaskName or FetchTasks
Example: | `GroupMessagesByInterval=10 minutes`
See Also: | GroupMessagesByCount

_FT_HTML5_bannerTitle.htm