Webitel: Documentation

Instruction for working with the State history tab of the Agents section (Supervisor)

1. Description

The State history tab is designed to view the chronology of states in which the Agent has been. It allows tracking periods of activity, pauses, waiting, missed calls, queue time, and other statuses throughout the working day.

The page consists of the following elements (Fig. 1):

  • Top bar with Agent information and status (Fig. 1.(1));

  • Filter panel (Fig. 1.(2));

  • Table with the list of states (Fig. 1.(3));

  • Pagination elements (Fig. 1.(4)).

State history.png
Fig. 1. State history tab

1.2. How to change the Agent status

To change the current status of an Agent, make sure you have the appropriate permissions.

  1. On the top bar, find the block displaying the current status of the Agent and the timer showing the duration of this status (Fig. 2).

Status_State history.png
Fig. 2. Agent top bar
  1. Click on the timer field. A drop-down list of all available statuses will appear:

  • image-20250731-135953.png – Offline;

  • image-20250731-140011.png – Online;

  • image-20250731-140039.png – Pause.

  1. Select the required status by clicking on it.

If you select the Pause status:

  • the Select a pause cause modal window opens automatically (Fig. 3);

Select a pause cause.png
Fig. 3. Select the reason for the pause modal window
  • choose the required reason from the list;

  • after selecting, click the OK button.

Important: A Supervisor can only transfer an Agent to those pauses for which the “Supervisor can change this status” option is enabled in Admin → Agent Statuses.

If this option is disabled, the status will not appear for the Supervisor in the drop-down list.

After the status is changed:

  • the Agent status is updated on the panel;

  • the timer resets and starts counting from the new status.

Changing status on State history tab.png
Fig. 4. Example of updated Agent status

1.3. How to call an Agent

On the State history tab, you can directly initiate a call to the Agent if you have the appropriate permissions.

If the Agent has Do Not Disturb mode enabled, the internal call will not be delivered.

To make a call:

  1. Click the Call button on the top bar (Fig. 5).

Call_button_State history.png
Fig. 5. Call button on the top bar
  1. A minimized call window appears in the lower-right corner (Fig. 6). Dialing begins.

Окно звонка.png
Fig. 6. Call window
  1. When hovering over the window, it expands (Fig. 7), showing control elements:

  • image2024-2-27_16-45-13.png – mute microphone button;

  • image2024-2-27_16-45-33.png – microphone off;

  • image2024-2-27_16-46-15.png – hold button;

  • image2024-2-27_16-50-24.png – Call on hold.

Развернутое окно звонка..png
Fig. 7. Expanded call window
  1. To end the call, click the End Call icon image2024-2-27_16-52-37.png .

After completion:

  • the call window closes automatically;

  • you return to the current Agent card view.

1.4. How to work with the registry of records

Below the filter panel, a table is displayed containing the list of states in which the Agent has been (Fig. 8).

Registry (State history).png
Fig. 8. States table

The table includes:

  • Select visible columns icon (Fig. 8.(1));

  • Manual refresh icon (Fig. 8.(2));

  • The data table itself (Fig. 8.(3)).

The table is updated automatically every 10 seconds.

The table displays the states recorded within the contact center:

  • State — the status in which the Agent was (e.g., Waiting, Break out, Online, Pause, etc.);

  • Start — the time when the state began;

  • End — the time when the state ended;

  • Duration — the total amount of time spent in this state.

The full list of possible states and their descriptions can be found in the documentation.

1.4.1. How to select visible columns

To configure which columns are displayed in the table:

  • Click the Select visible columns icon image-20250807-150911.png (Fig. 8.(1)) — the Select visible columns modal window opens (Fig. 9).

  • Check the boxes for the columns you want to display.

  • Clear the boxes for the columns you don’t want to display.

  • Close the window — the table updates according to your selection.

Modal window - Select visible columns.png
Fig. 9. Select visible columns modal window

1.4.2. How to refresh the table

To refresh the data manually, click the Refresh icon image-20250807-151328.png (Fig. 8.(2)).

The table data is updated automatically every 10 seconds.

1.5. How to apply state filters

The filter panel on the State history tab allows selecting state records by specific parameters. The panel is located below the top bar and includes the following elements (Fig. 10):

  • Filtering fields (Fig. 10.(1));

  • Reset filters icon (Fig. 10.(2));

  • Expand filters icon (Fig. 10.(3)).

Filters block on State history tab.png
Fig. 10. State records filter panel

To filter by a specific period:

  1. Click the From field — the calendar opens.

  2. Select the start date and time of the required period.

  3. Click Add — the selected date appears in the field.

  4. Repeat the same steps for the To field to set the end date of the period.

To reset all selected filters, click the Reset filters icon (Fig. 10.(2)) — all fields will be cleared.

If some filtering fields are hidden, you can expand them by clicking the Expand filters icon image-20250807-145930.png (Fig. 10.(3)).

After applying filters, the records table updates automatically and displays only those records that match the selected conditions.

1.6. How to view table pages

Pagination elements are available below the records table:

  • Buttons to navigate to the previous or next page;

  • Rows per page selector: 10, 25, 50, etc.

Pagination on State history tab.png
Fig. 11. Pagination elements at the bottom of the table