Webitel: Documentation

General (Storage policies)

1. Description

Used to specify general information about the policy.

Consists of the following fields (Fig. 1):

  1. Name;

  2. Description;

  3. State;

  4. Encrypt files;

  5. Channels;

  6. MIME types;

  7. Retention days;

  8. Maximum upload speed (kbps);

  9. Maximum download speed (kbps);

  10. Maximum file size (bytes).

Storage policies.png
Fig. 1. General tab

1.1. Name

This field specifies the name of the policy.

1.2. Description

The policy description that provides additional context.

1.3. State

The status of the policy indicating whether it is active. A toggle is used — enabled image-20250418-121804.png or disabled image-20250418-121829.png . By default, the policy is enabled.

1.4. Encrypt files

A toggle that determines whether files stored according to the policy will be encrypted.

If the option is enabled – image-20250418-121804.png , all uploaded files (except for the "media" and "chat" types) are stored in encrypted form.

1.5. Channels

The channels to which this policy will be applied. The administrator can choose from a list of available channels (chat, email, call, log, media, screen recordings).

1.6. MIME Types

The file types that will be stored under this policy.

The user can:

  • select MIME types from the standard list;

  • add custom MIME types manually.

All selected values are displayed as chips with the option to remove them.

Important! If a user in the chat tries to upload a file that does not match the defined MIME types, the system sends a message about a forbidden or incorrect file format (see section 1.5. Forbidden file format message).

1.6.1. Standard MIME Types

The system contains a predefined list of the most common MIME types.

The user can select one or several types from this list.

Images

Format

MIME-type

JPEG

image/jpeg

PNG

image/png

GIF

image/gif

SVG

image/svg+xml

WebP

image/webp

Video

Format

MIME-type

MP4

video/mp4

WebM

video/webm

MPEG

video/mpeg

Audio

Format

MIME-type

MP3

audio/mpeg

WAV

audio/wav

Documents

Format

MIME-type

PDF

application/pdf

MS Word (.doc)

application/msword

Word (.docx)

application/vnd.openxmlformats-officedocument.wordprocessingml.document

Standard MIME types can be combined with user-defined values.

1.6.2. Standard Policies and Behavior for Existing Users

For users who already have created policies, the system automatically adds three standard policies to the Storage Policies section:

Policy 1: media_storage

Field

Value

Name

media_storage

MIME Types

image/jpeg, image/png, video/mp4, audio/mpeg, audio/wav

Retention days

365

Maximum upload speed (kbps)

2048

Maximum download speed (kbps)

1024

Maximum file size (bytes)

52,428,800

Channels

chat

Policy 2: email_attachment

Field

Value

Name

email_attachment

MIME Types

application/pdf, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, image/*

Retention days

365

Maximum upload speed (kbps)

1024

Maximum download speed (kbps)

512

Maximum file size (bytes)

10,485,760

Channels

email

Policy 3: call_recordings

Field

Value

Name

call_recordings

MIME Types

audio/mpeg, audio/wav

Retention days

365

Maximum upload speed (kbps)

1024

Maximum download speed (kbps)

512

Maximum file size (bytes)

20,971,520

Channels

call

The standard list of MIME types is immediately available in the MIME Types field and can be used when configuring policies.

Standard policies are added in a disabled state, are not mandatory for use, and can be edited or deleted by the user. They do not affect existing settings until the user manually enables one of them.

1.7. Retention Days

The number of days the files will be stored before being automatically deleted.

1.8. Maximum Upload Speed (kbps)

The maximum upload speed in kilobits per second applied to files under this policy. If the value is 0, the restriction is not applied.

1.9. Maximum Download Speed (kbps)

The maximum download speed in kilobits per second applied to files under this policy. If the value is 0, the restriction is not applied.

1.10. Maximum File Size (bytes)

The maximum allowed file size for upload in bytes. If the value is 0, there is no file size restriction.

2. Applying the Policy to Existing Files

After creating a policy, it can be applied to already existing files. For this, the "Apply" button is used (Fig. 2).

Apply.png
Fig. 2. “Apply” button

Clicking this button opens a modal window (Fig. 3) with two available buttons:

  • OK — applies the new policy to existing files;

  • CANCEL — closes the modal window without any changes.

Apply retention days to existing files.png
Fig. 3. Modal window for applying the policy to existing files

Changes take effect 30 seconds after confirmation.

3. Features

3.1. Modify or Set Parameters

Goal

Modify or set parameters

Preconditions

  1. Access to the "Admin" application;

  2. Access to the "Storage Policies" section in Admin;

  3. Permission to view and delete entries in the "Storage Policies" section;

  4. At least one existing policy or create a new one.

Steps:

 

  1. Click the field you want to modify.

  2. Enter the required changes (for the "Name" field, the data must be unique).

  3. Click the "Save" button.

Result

Data is saved.