Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

RealtimeAlertEvent

Notifies subscribers of Amazon CloudWatch alarm events from your Service Cloud Voice Amazon Connect instance. This object is available in API version 54.0 and later.

Supported Calls

describeSObjects()

Supported Subscribers

Subscriber	Supported?
Apex Triggers
Flows
Processes
Pub/Sub API
Streaming API (CometD)

Subscription Channel

/event/RealtimeAlertEvent

Special Access Rules

Accessing this object requires Service Cloud Voice with Amazon Connect enabled.

Event Delivery Allocation Enforced

Yes

Fields

Field	Details
Description	Type string Properties None Description Required. Description of the alert fired.
EventDateTime	Type datetime Properties None Description Date and time when the alert occurred. For example: `2020-12-18 21:59:48`.
Name	Type string Properties None Description Required. Name of the alert fired.
Payload	Type string Properties None Description More information and data associated with the alert.
Severity	Type string Properties None Description Required. Severity of the triggered alarm. Possible values: Critical Warning Information When using Amazon CloudWatch with Service Cloud Voice, the following alarm states map to severity values: ALARM maps to Critical INSUFFICIENT_DATA maps to Warning OK maps to Information
Source	Type string Properties None Description Required. The source of the alert. For example, this value can be the service name: `AWS Cloudwatch`.

Usage

The following example shows how to process RealtimeAlert events. This Apex trigger example fires when a platform event message is published and creates a Chatter post on the admin profile with event details.

1trigger RealtimeAlertEventTrigger on RealtimeAlertEvent (after insert) {
2   Id profileId = [select Id from User where User.Profile.Name = 'System Administrator' limit 1].Id;
3    for(RealtimeAlertEvent e : trigger.new) {        
4       Feeditem Post = New Feeditem();
5       Post.ParentId= profileId;
6       Post.Body = 'Alert occurred in the service: ' + e.Source + '\n' +
7            'Name: ' + e.Description + '\n' +
8            'Severity: ' + e.EventDateTime + '\n' +
9            'Payload: ' + e.Payload + '\n' +
10            'EventDate: ' + e.EventDateTime + '\n' +
11            'Description: ' + e.Name + '\n';
12       insert Post;
13    }
14}

Example

The code example displays as a Chatter post that contains the following:

1Alert occurred in the service: aws cloudwatch alarm
2Name: alert description
3Severity: 2021-11-05 11:11:11
4Payload: payload
5EventDate: 2021-11-05 11:11:11
6Description: alert name

Platform Events Developer Guide