You are here:
Event Channels
An event relay uses an event channel. A channel is a stream of events in the Salesforce event bus. A single channel can contain multiple types of platform events, including real-time event monitoring events, or change data capture events.
Each event relay is associated with a unique channel that’s identified by its channel ID. Don’t reuse a channel for another event relay.
Custom Channels for Platform Events and Change Events
Use a custom channel to group event messages from one or more events through channel members.
For example, for platform events, if MyEvent1__e is a
custom platform event defined in Salesforce, create a channel to receive event messages for
MyEvent1__e if you add a channel member for MyEvent1__e. To receive event messages for another event on that
channel, such as MyEvent2__e, add a channel member for
MyEvent2__e.
For the maximum number of custom channels that you can create for custom platform events and real-time event monitoring events, see Common Platform Event Allocations in the Platform Events Developer Guide.
Similarly, for change data capture, you can create a custom channel to receive change event
messages. If you create a channel for changes in one Salesforce object, such as AccountChangeEvent, the channel contains one member for AccountChangeEvent. To receive events for another Salesforce
object, such as LeadChangeEvent, add another channel
member.
For more information about creating custom channels, see Create a Channel and Channel Members.
For the maximum number of channels that you can create for change events, see Default Change Event Allocations in the Change Data Capture Developer Guide.
The Standard ChangeEvents Channel
The predefined standard channel ChangeEvents includes all
change events that correspond to the Salesforce objects that you select in Setup. You can select
ChangeEvents from the channel’s dropdown in the event
relay creation wizard. Before you can use the standard ChangeEvents channel, from Setup, select the objects that you want change events for
in the Change Data Capture page. For more information, see Select Objects for Change Notifications in
the User Interface in the Change Data Capture Developer Guide.
Filtered Channels for Platform Events and Change Events
Add a filter to a custom channel and send only events that match the filter criteria to Amazon EventBridge. By using a filtered channel, you reduce the volume of events relayed to Amazon EventBridge, process events efficiently, and decrease the consumption of the event delivery allocation. Event relay filtering is available for custom channels that reference custom platform events and change events but not for real-time event monitoring events.
To add a filter to a platform event channel, see Filter Your Stream of Platform Events with Custom Channels in the Platform Events Developer Guide.
To add a filter to a change data capture channel, see Filter Your Stream of Change Events with Channels in the Change Data Capture Developer Guide.
Change Event Enrichment in Channels
Change event messages include values for new and changed fields, but sometimes unchanged field values are needed for processing or replicating data. To enrich change events with one or more fields that are always present in the event message, create a custom channel with enriched fields. To learn how to add enrichment, see Enrich Change Events with Extra Fields in the Change Data Capture Developer Guide.
