Category

How to Configure and Use Requester Timeline in BoldDesk

Updated:

The Requester Timeline in BoldDesk brings a requester’s interactions together in one chronological view. Agents can review previous tickets, chats, proactive messages, activities, and contact events before responding.
A requester in BoldDesk can be either a contact or an agent. Because of this, the Requester Timeline is available not only in contact-related views, but also in the Agent Details page when the agent is the requester in a ticket or chat.

Administrators can control which events appear in the timeline. If an optional event is hidden, BoldDesk continues to record it and it can be displayed again later.
Configured timeline events appear in the following locations:

  • Chat Details sidebar as Requester Timeline
  • Ticket Details sidebar as Requester Timeline
  • Contact Details page under Recent Timeline
  • Agent Details page under Recent Timeline when the agent is the requester

Hiding an optional event removes the event from the visible timeline but does not stop BoldDesk from recording it.

How Requester Timeline Works

Requester Timeline contains 14 events grouped by module.

Event Group Number of Events
Ticket & Chat 4
Proactive 2
Activity 4
Contact 4
Total 14

Administrators can show or hide optional events by using the Show in Timeline toggles.

Ticket and Chat events are default events and cannot be disabled.

Common Use Cases

  • Review a requester’s previous tickets and chats.
  • Identify when tickets were created, closed, or reopened.
  • View proactive SMS and WhatsApp interactions.
  • Review tasks, meetings, calls, and custom activities.
  • Track contact creation, verification, state changes, and notes.
  • View requester history from the Agent Details page when the agent is the requester.
  • Give agents requester context without opening multiple records or modules.

Enable Requester Timeline

Navigate to:
Admin > Help Desk > Requester Timeline

To enable Requester Timeline:

  1. Open Admin from the left navigation menu.

  2. Under Help Desk, select Requester Timeline.

  3. Turn on the Requester Timeline toggle.

    Enable Requester Timeline.png

When Requester Timeline is disabled:

  • Agents cannot view the timeline in supported locations.
  • The Timeline API returns no data.
  • Timeline events continue to be recorded.
  • Saved event visibility settings are retained.

When Requester Timeline is enabled again, the previously saved event visibility settings are restored.

Configure Timeline Events

After enabling Requester Timeline, choose which events agents can view.
The configuration page displays:

  • Events grouped by module

  • A Show in Timeline toggle for each configurable event

  • A visible-event count for each module

  • An overall visible-event count

  • A Save button for applying changes

    Configure Timeline Event.png

Configure Ticket and Chat Events

Expand Ticket & Chat to view the default events.

Event Description
Ticket Created When a new ticket is created by a requester.
Ticket Closed When a ticket is closed by an agent or requester.
Ticket Reopened When a closed ticket is reopened.
Chat Created When a new chat conversation is started by a requester.

Ticket and Chat Events.png

Ticket and Chat events are default events and cannot be disabled.

Configure Proactive Events

Expand Proactive to configure proactive communication events.

Event Description
Proactive SMS Created When a proactive SMS is sent to the requester.
Proactive WhatsApp Message Created When a proactive WhatsApp message is sent to the requester.

Use the Show in Timeline toggle to show or hide each event.

Proactive Event.png

The counter beside the group shows how many Proactive events are visible. For example, disabling Proactive SMS Created while keeping Proactive WhatsApp Message Created enabled displays 1 of 2 shown.

Configure Activity Events

Expand Activity to configure activity-related events.

Event Description
Task Activity Created When a task activity is logged on the requester.
Meeting Activity Created When a meeting activity is logged on the requester.
Call Activity Created When a call activity is logged on the requester.
Custom Activity Created When a custom activity is logged on the requester.

Each Activity event can be shown or hidden independently.

Configure Activity Events.png

Configure Contact Events

Expand Contact to configure contact-related events.

Event Description
Contact Created When a new contact is created for the requester.
Contact Verified When the requester’s contact details are verified.
Contact State Changed When the requester’s contact state is changed.
Contact Note Added When a note is added to the requester’s contact.

Each Contact event can be shown or hidden independently.

Configure Contact Events.png

Save the Configuration

After changing event visibility:

  1. Review the enabled events in each group.

  2. Confirm the visible-event count displayed beside each group.

  3. Confirm the overall count displayed at the top of the page.

  4. Click Save.

    Save Configuration.png

The counter beside each group shows how many events in that group are visible. The counter at the top shows the total number of visible events across all groups.

View Requester Timeline in the Agent Portal

The configured events appear in the following Agent Portal locations:

Location Timeline Access
Chat Details Requester Timeline tab in the sidebar
Ticket Details Requester Timeline tab in the sidebar
Contact Details Recent Timeline tab
Agent Details Recent Timeline tab when the agent is the requester

View Requester Timeline in Chat Details

Open the Requester Timeline tab in the Chat Details sidebar to review the requester’s previous interactions.
The timeline can display:

  • Requester name and email address

  • Contact verification status

  • Ticket events

  • Chat conversation events

  • Current ticket or conversation status

  • Event date and time

  • Links to related tickets and conversations

    Timeline in Chat Details.png

Use the refresh option to load the latest timeline events.

Requester Timeline Availability in Chat

The Requester Timeline tab is not displayed in Chat Details when the requester cannot be identified as a verified or linked contact.
In this situation, the sidebar can display:

  • Visitor details

  • Not Verified status

  • Conversation Not Verified status

  • Link Contact option

    Timeline Availability in Chat.png

Use Link Contact to associate the chat visitor with the appropriate BoldDesk contact.

Requester Timeline is not available in Chat Details when the requester cannot be verified or linked to a contact. Link the visitor to the correct contact to make the requester’s recorded interaction history available.

View Requester Timeline in Ticket Details

Open the Requester Timeline tab in the Ticket Details sidebar to review previous interactions associated with the requester without leaving the current ticket.

The timeline can display:

  • Previous ticket events

  • Previous chat conversations

  • Contact verification events

  • Contact state changes

  • Current ticket status

  • Event date and time

  • Links to related records

    Timeline in Ticket Details.png

Select an event title to open the related record where applicable. Use the refresh option to load the latest events.

View Recent Timeline in Contact Details

Open a contact and select Recent Timeline to review configured events associated with the contact.

The timeline can display:

  • Ticket creation events

  • Ticket closure and reopening events

  • Chat conversation events

  • Proactive communication events

  • Task, meeting, call, and custom activity events

  • Contact creation events

  • Contact verification events

  • Contact state changes

  • Contact notes

    Timeline in contact details.png

Ticket and conversation events display the current record status where applicable. Each event also displays its recorded date and time.

View Recent Timeline in Agent Details

Open an agent and select Recent Timeline to review configured events associated with that agent as a requester.
The Recent Timeline tab in Agent Details displays requester timeline entries only when the agent is the requester in a ticket or chat.
This means the Agent Details page does not show a separate agent activity timeline. Instead, it shows the same requester timeline context for that agent when the agent appears as the requester record.

The timeline can display:

  • Ticket events where the agent is the requester

  • Chat events where the agent is the requester

  • Other configured requester-related timeline events associated with that requester record

  • Event date and time

    Timeline in Agent Details.png

If no requester-related events exist for that agent, the Recent Timeline tab may display an empty state such as No Timeline Found.

The Recent Timeline tab in Agent Details shows requester timeline information only when the agent is the requester in a ticket or chat.

Event Visibility Behavior

Configuration Result
Requester Timeline enabled Agents can view configured events in supported locations.
Requester Timeline disabled Agents cannot view the timeline, and the Timeline API returns no data.
Optional event enabled The event appears in the supported timeline locations.
Optional event disabled The event is hidden but continues to be recorded.
Default Ticket or Chat event The event remains visible and cannot be disabled.
Unverified or unlinked chat requester The Requester Timeline tab is not displayed in Chat Details.
Agent is requester The Recent Timeline tab in Agent Details displays requester-related timeline events for that agent.
Agent is not requester The Recent Timeline tab in Agent Details may display no timeline entries.

Troubleshooting

Requester Timeline Is Not Visible

Confirm that:

  • Requester Timeline is enabled under Admin > Help Desk > Requester Timeline
  • The configuration was saved
  • The agent can access the applicable ticket, contact, chat, or agent record
  • Timeline events exist for the requester

Requester Timeline Is Missing in Chat Details

Confirm that:

  • The visitor is linked to a BoldDesk contact
  • The requester or conversation is verified
  • The chat is associated with the correct contact

If the sidebar displays Not Verified or Conversation Not Verified, use Link Contact to associate the visitor with the appropriate contact.

An Expected Event Is Missing

Confirm that:

  • The event is enabled under Show in Timeline
  • The configuration was saved
  • The event occurred for the same requester
  • The requester is associated with the correct contact or agent record
  • The timeline has been refreshed

An Event Cannot Be Disabled

Ticket and Chat events are default events. Default events cannot be disabled.

No Timeline Found in Agent Details

If the Recent Timeline tab in Agent Details shows No Timeline Found, confirm that:

  • The agent is the requester in at least one ticket or chat
  • Relevant requester-related events have been recorded
  • The current configuration allows those events to appear
  • Requester Timeline is enabled

Frequently Asked Questions

  1. What is Requester Timeline?
    Requester Timeline provides agents with a chronological view of configured ticket, chat, proactive communication, activity, and contact events associated with a requester.

  2. Who can be a requester in BoldDesk?
    A requester can be either a contact or an agent.

  3. Where is Requester Timeline configured?
    Go to Admin > Help Desk > Requester Timeline.

  4. Where can agents view the timeline?
    Configured events appear in the Chat Details sidebar, Ticket Details sidebar, the Recent Timeline tab on the Contact Details page, and the Recent Timeline tab on the Agent Details page when the agent is the requester.

  5. Does Agent Details show a separate agent activity timeline?
    No. The Recent Timeline tab in Agent Details shows requester timeline entries only when the agent is acting as the requester in a ticket or chat.

  6. Can administrators choose which events are displayed?
    Yes. Optional events can be shown or hidden through the Show in Timeline toggles.

  7. Can Ticket and Chat events be disabled?
    No. Ticket and Chat events are default events and cannot be disabled.

  8. What happens when an optional event is hidden?
    The event no longer appears in the visible timeline, but BoldDesk continues to record it.

Related Articles

  1. How to Add and Edit Contacts in BoldDesk
  2. How to Add Private Notes to Tickets in BoldDesk
Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
Comments (0)
Access denied
Access denied
Access denied
Access denied

No articles or sections found
No articles or sections found