Skip to main content
Feedback

Salesforce Platform Events connector

Use the Salesforce Platform Events connector to configure the integration between Salesforce Platform Events and connected business applications.

Salesforce Platform Events is a feature in the Salesforce enterprise messaging platform and helps organizations run faster and more efficiently through event-driven business processes that execute in near-real time. For example, an event such as the creation of a new opportunity in Salesforce can be published to a SMS messaging or email system to immediately alert a sales representative to follow up on a potential sale. In addition, Salesforce Platform Events can be connected to smart printers to monitor the status of ink cartridges. When a cartridge is low, Salesforce Platform Events can automate the reordering from the supplier.

The Salesforce Platform Events connector passively listens for events that are published through Platform Events and also listens for events from connected applications to update Platform Events and trigger actions. This listening provides real-time connectivity and more immediacy in business processes and minimizes resource requirements. Applications can communicate inside and outside of Salesforce.

Connector configuration

To configure the connector to communicate with Salesforce Platform Events, set up two components:

  • Salesforce Platform Events connection. This connector uses the OAuth 2.0 protocol for authentication and authorization.

  • Salesforce Platform Events operation (Listen and Send)

This design provides reusable components, which contain connection settings and operation settings. After building your connection and operation, set up your connector within a process. When the Salesforce Platform Events connector is configured properly within your process, Integration can map to and from virtually any connected application using the Salesforce Platform Events connector to listen for and send messages.

Supported editions

The Salesforce Platform Events connector supports:

  • The Salesforce API version 41.

Prerequisites

To use the Salesforce Platform Events connector to implement a connection to your Salesforce account from Integration, have your Salesforce client ID and client secret that was provided when you created your account.

Limitations

The following known limitations affect this connector:

  • The limitation of the connector is that, by default runtimes store replayId in memory. This means that a runtime restart or crash will wipe that replayId from the listener. To resolve potential duplicated messages around runtime restarts and other extended downtime enabling a persistence feature will allow replayId to be more accurate. See the following topic: Enabling connector property persistence.

Pausing all listeners sharing the same connection will result in loss of replayId tracking unless you have persistence enabled. It is also not recommended to create multiple Connector Operations listening to the same channel on the same connection as replayIds are tracked by channel for a connection. For example having 3 processes all dedicated to listening to EVENT_A, using the same connection. As an alternative please consider using a single listener process routing to multiple subprocesses for EVENT_A.

Tracked properties

This connector has no predefined tracked properties. See the topic Adding tracked fields to a connector operation to learn how to add a custom tracked field.

On this Page