Actionable Telematics Event Business API and Platform Events

Different methods are available to bring asset events into Salesforce and execute actions on the event. Use the Actionable Orchestration Source Event platform event to publish events or use the Orchestration Inbound Events business API to trigger events. The platform event and the business API can be easily integrated with any external system, such as telematics provider systems.

Required Editions

Available in: Lightning Experience

Available in: Automotive Cloud, Communications Cloud, Consumer Goods, Energy and Utilities Cloud, Manufacturing Cloud, and Media Cloud. View edition availability.

Here’s the process to use the platform event framework to ingest events.

Phase 1 – Prepare Input Data: The request payload must contain the source system identifier and event type at a minimum. In addition, event subtype and event category can also be specified. For additional events data, make sure the JSON structure matches the nodes and attributes for a context definition.
Phase 2 – Publish the Source Event: Publish the Actionable Orchestration Source Event platform event from an external system so that you can establish the connection between the external system and Salesforce. Salesforce receives all events originating in the external system after the platform event is published.
Phase 3 – Subscribe to the Response Event: Subscribe to Actionable Orchestration Response Event to notify the external system after an action is executed for the source event. The response contains the details of the executed action, the processing status of the source event, and the error description for a failed event.

For details, see Platform Events Developer Guide.

Perform these high-level steps if you use the business API to ingest events.

Prepare Input Data: The request payload must contain the source system identifier and event type at a minimum. In addition, event subtype and event category can also be specified. For additional events criteria, make sure the JSON structure specifies the key-value pairs for each type of detail.
Trigger the API: Use a POST method to trigger the API that automatically invokes the actionable event orchestration framework.
Review the Results: Review the API response, which lists the actions taken by the orchestration process for a specified event. The response contains the details of the executed action, the processing status of the source event, and the error description for a failed event.

For details, see Orchestration Events (POST).