Definition

The minimum number of days for which a chat transcript must be retained. Setting the value to zero retains transcripts indefinitely.

Description

You may want your OneBot instance to delete the transcripts of inactive chats. For example, in the EU, laws surrounding General Data Protection Regulation (GDPR) require organisations that process personal data to keep it, ‘… no longer than necessary … ’. Configure the transcript retention policy to cause OneBot to automatically delete chat transcripts after a specified retention period.

Currently, the duration for transcript retention is set using a whole number value. The resulting minimum number of hours a chat transcript is retained for is calculated as the value you set, multiplied by 24 hours. For example, a transcript retention policy set to a value of ‘3’ results in a minimum transcript retention duration of 72 hours. Only whole numbers can be used to set a value for a transcription retention policy.

Chat transcripts are not deleted the moment they cross their policy threshold. Instead, transcripts are deleted at some point in the following 24 hour period. Specifically, OneBot carries out retention policy checks each day at 00:00 Coordinated Universal Time (UTC), and immediately deletes any transcripts found to have passed their policy threshold. This means chat transcripts may be retained for up to 24 hours longer than the minimum retention duration calculated from the value set as the transcription retention policy.

In general, if you need to enforce a maximum threshold, set a value that is ‘one less than’ the maximum number of days you want transcripts to be retained. For example, if you want to ensure chat transcripts are retained for no more than 10 days (i.e.: no more than 240 hours after the latest chat activity) set the value for the minimum transcription retention policy to ‘9’. This will result in any aged transcripts being deleted at some point in the 24 hours immediately after nine twenty-four hour periods elapse after the last chat activity.

Currently, OneBot can be configured to retain chat transcripts indefinitely simply by setting the value for the transcript retention policy to zero. Consequently, setting the transcript retention policy to zero does not cause chat transcripts to be instantly deleted; this also means all OneBot chat transcripts are retained for a minimum of 24 hours.

v3.0