Custom sessions and custom events
Understand how to capture information about customer activity in your third-party system and present it to agents.
- Configure the following permissions in Genesys Cloud:
- To see custom sessions and custom events, assign agents specific permissions.
With Genesys Predictive Engagement's RESTful Journey API, you can use custom sessions and custom events to track a customer's experience with your organization across a variety of third-party products and systems. A custom session represents a sequential set of related organization-specific events that occur in a third-party system, for a particular user within a given period. These events are custom events.
Use the Session Library to configure how to present this activity to agents.
Send a custom event to start a custom session
Scenario: Bike delivery
1: Order placed
A customer visits a retail store and orders a custom bike. Because it is a special order, the customer requests that the bike be delivered directly to his house. When the customer places the order, the shipment tracking system calls the Custom Events API and sends Predictive Engagement a custom event called "product_purchased" for a session of type "delivery".
The API call includes a unique external Id for the session. When Predictive Engagement receives the API request, it automatically creates a new custom session and sets the event count to 1. For an example, see the API call for the first custom event.
2: Dispatch delayed
Unfortunately, one of the bike components is not available in the warehouse and delivery is delayed. The order entry system sends an email to the customer to notify them, and it also uses the CustomEvents API to send Predictive Engagement a second custom event in the session. For an example, see the API call for the second custom event.
3: In transit
Eventually, the custom bike is complete and shipped. The shipment tracking system sends an "in transit" custom event to Genesys Predictive Engagement.
4: Item deliveredThe bike is delivered, and the shipping tracking system sends a "delivered" custom event to Genesys Predictive Engagement.
Custom session types
Each custom session has a type. The session type is set in the API request when the first custom event in the session arrives. You cannot change this type. For more information about setting the session type through the API, see the Session types API in the Developer Center.
The session type acts as a template that contains specific attributes that you define in the Session Library. All sessions of a given type share the same attributes. The attributes that you define for a given session type are visible to agents when they view any session of that type.
For example, in the bike delivery scenario, the session type is delivery. Compare the type of data agents need about delivery sessions (such as transit status and arrival times) to the type of data that agents need about ATM transactions (such as pre- and post- transaction balances and transfer account number). Different types of custom sessions require different sets of custom data.
Attributes for custom event types
Configure how agents view custom events
You have several tools for configuring how data about custom sessions appears to agents. Start by reading Session attributes and Use a projection to present a consolidated view of multiple data points. Next, read Event types and Make event information meaningful to agents.