How to Configure and Use Requester Timeline in BoldDesk
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:
-
Open Admin from the left navigation menu.
-
Under Help Desk, select Requester Timeline.
-
Turn on the Requester Timeline toggle.
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 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 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.
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 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.
Save the Configuration
After changing event visibility:
-
Review the enabled events in each group.
-
Confirm the visible-event count displayed beside each group.
-
Confirm the overall count displayed at the top of the page.
-
Click Save.
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
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
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
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
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
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
-
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. -
Who can be a requester in BoldDesk?
A requester can be either a contact or an agent. -
Where is Requester Timeline configured?
Go to Admin > Help Desk > Requester Timeline. -
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. -
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. -
Can administrators choose which events are displayed?
Yes. Optional events can be shown or hidden through the Show in Timeline toggles. -
Can Ticket and Chat events be disabled?
No. Ticket and Chat events are default events and cannot be disabled. -
What happens when an optional event is hidden?
The event no longer appears in the visible timeline, but BoldDesk continues to record it.