Flow Actions
Bolt Data Connect provides a set of Invocable Actions that can be used in Flows, including Record-Triggered Flows, Screen Flows, Autolaunched Flows and Platform Event-Triggered Flows. These Actions let you process IoT Alerts, register Things and Gateways, look up current and historical sensor data, and keep Thing records in sync with the IoT Cloud.
Using the Actions
- In Flow Builder, add an Action element to your Flow.
- Search for IoT in the Action search box. All Bolt Data Connect Actions begin with “IoT”.
- Select the Action, then map the input values and store the output values as described below.
Note
Input values marked Required must be provided. In the Flow Builder, a parameter without a custom label is shown using the name listed below.Alert Actions
IoT Alert Automation
Automation for IoT Alerts including Alert History, Alert Response and Thing Downtime. Use this Action in a Platform Event-Triggered Flow on the IoT Alert Platform Event.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| alert | IoT Alert (Platform Event) | Yes | The IoT Alert record that triggered the Flow. |
Outputs
| Name | Type | Description |
|---|---|---|
| alert | IoT Alert (Platform Event) | The IoT Alert that was processed. |
IoT Gateway Alert Automation
Automation for IoT Gateway Alerts including Auto-Registering, Updates and Alert History. Use this Action in a Platform Event-Triggered Flow on the IoT Gateway Alert Platform Event.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| alert | IoT Gateway Alert (Platform Event) | Yes | The IoT Gateway Alert record that triggered the Flow. |
Outputs
| Name | Type | Description |
|---|---|---|
| alert | IoT Gateway Alert (Platform Event) | The IoT Gateway Alert that was processed. |
IoT Response Alert Automation
Automation for IoT Response Alerts including Alert History. Use this Action in a Platform Event-Triggered Flow on the IoT Response Alert Platform Event.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| alert | IoT Response Alert (Platform Event) | Yes | The IoT Response Alert record that triggered the Flow. |
Outputs
| Name | Type | Description |
|---|---|---|
| alert | IoT Response Alert (Platform Event) | The IoT Response Alert that was processed. |
Thing and Gateway Actions
IoT Create Thing Callback
Creates and registers a Thing with the IoT Cloud Gateway, then updates the Salesforce Thing record with the External Key, Thing Type and Gateway.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| recordId | Id | Yes | The Id of the Salesforce Thing record. |
| externalKey | Text | No | The unique key (Thing ID) used to identify the Thing in the IoT Cloud. |
| thingType | Text | No | The Thing Type, by Thing Type label or name. |
| gatewayID | Text | No | The ID of the Gateway the Thing is connected through. |
Outputs
| Name | Type | Description |
|---|---|---|
| recordId | Id | The Id of the Salesforce Thing record. |
| externalKey | Text | The External Key of the Thing. |
| thingType | Text | The Thing Type. |
| gatewayID | Text | The ID of the Gateway. |
| message | Text | The result message from the IoT Cloud. |
IoT Create Gateway Callback
Creates and registers a Gateway with the IoT Cloud, and updates the Salesforce IoT Gateway record with the Gateway ID and Type.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| recordId | Id | Yes | The Id of the Salesforce IoT Gateway record. |
| externalKey | Text | No | The unique key (Gateway ID) used to identify the Gateway in the IoT Cloud. |
| thingType | Text | No | The Gateway Type, by Thing Type label or name. |
| connectivityInfo | List of Connectivity Info | No | Connectivity details for the Gateway. If not provided, connectivity is configured automatically. |
Outputs
| Name | Type | Description |
|---|---|---|
| recordId | Id | The Id of the Salesforce IoT Gateway record. |
| externalKey | Text | The External Key of the Gateway. |
| thingType | Text | The Gateway Type. |
| message | Text | The result message from the IoT Cloud. |
IoT Registration Callback
Calls the IoT Cloud Registration API for each Thing, and updates the Salesforce Thing record with the registered Thing Type and Gateway ID.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| recordId | Id | Yes | The Id of the Salesforce Thing record to register. |
Outputs
| Name | Type | Description |
|---|---|---|
| recordId | Id | The Id of the Salesforce Thing record. |
| externalKey | Text | The External Key of the Thing. |
| thingType | Text | The Thing Type returned by the registration. |
| gatewayID | Text | The Gateway ID returned by the registration. |
IoT Update Thing Context
Pushes the current Thing Context to the IoT Cloud. The update is sent asynchronously, so the Flow continues without waiting for the result. The Thing’s sync status is updated once the update completes.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| recordId | Id | Yes | The Id of the Salesforce Thing record. |
Outputs
None.
Thing Data Actions
IoT Get Thing Details Callback
Loads a Thing and returns the configured detail fields.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| recordId | Id | Yes | The Id of the Salesforce Thing record. |
Outputs
| Name | Type | Description |
|---|---|---|
| recordId | Id | The Id of the Salesforce Thing record. |
| label | Text | The Thing’s label. |
| externalKey | Text | The External Key of the Thing. |
| thingType | Text | The Thing Type. |
| gatewayID | Text | The ID of the Gateway. |
| thingStatus | Text | The current status of the Thing. |
IoT Get Thing Details and Stats
Loads a Thing and returns its details along with the current IoT values (the latest sensor readings).
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| recordId | Id | Yes | The Id of the Salesforce Thing record. |
Outputs
| Name | Type | Description |
|---|---|---|
| recordId | Id | The Id of the Salesforce Thing record. |
| label | Text | The Thing’s label. |
| externalKey | Text | The External Key of the Thing. |
| thingType | Text | The Thing Type. |
| gatewayID | Text | The ID of the Gateway. |
| thingStatus | Text | The current status of the Thing. |
| detailsJSON | Text | The current sensor values, in JSON format. Returns {} if no values are available. |
Get IoT Thing History
Gets the Sensor (Telemetry) Data in JSON format for an Asset and optional time span. The JSON can be analyzed, for example by an Agentforce Agent, to answer questions including minimum, maximum and average calculations.
If only one of the Start or End Datetime values is provided, a 30-minute window is used on the other side. If neither is provided, the most recent history is returned.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| Thing Id | Id | Yes | Id of the Asset or Connected Device. |
| Start Datetime | Date/Time | No | The Start or Earliest Date and time requested. |
| End Datetime | Date/Time | No | The End or Latest Date and time requested. |
Outputs
| Name | Type | Description |
|---|---|---|
| Sensor Result | Text | Summary of the sensor results received, for example “Found 3 Sensors over 20 points in time.” |
| Sensor Data (JSON) | Text | Asset Sensor (Telemetry) Data in JSON format. Each entry contains a timestamp (in seconds) and the sensor values. |
IoT Create Data Snapshots
Creates an IoT Data Snapshot for a Thing or Parent Object. See Data Snapshots for details.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| recordId | Id | Yes | The Id of the Thing, or the secondary Parent Object, to snapshot. |
| startDatetime | Date/Time | Yes | The start of the time slice to capture. |
| endDatetime | Date/Time | Yes | The end of the time slice to capture. |
Outputs
| Name | Type | Description |
|---|---|---|
| dataSnapshotId | Id | The Id of the new IoT Data Snapshot record. |
| thingId | Id | The Id of the Thing the Snapshot belongs to. |
| parentId | Id | The Id of the secondary Parent Object, if any. |
IoT Parse Thing Data Value
Parses a single value out of Thing Data JSON. Use this Action when you only need the value within the Flow.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| thingData | Text | Yes | The Thing Data, in JSON format. |
| fieldName | Text | Yes | The name of the field in the Thing Data to read. |
Outputs
| Name | Type | Description |
|---|---|---|
| value | Text | The value of the requested field, or empty if the field is not found. |
IoT Update Thing Data Field
Parses a single value out of Thing Data JSON and saves it to a field on the Thing record.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| recordId | Id | Yes | The Id of the Salesforce Thing record to update. |
| thingData | Text | Yes | The Thing Data, in JSON format. |
| thingDataField | Text | Yes | The name of the field in the Thing Data to read. |
| thingObjectField | Text | Yes | The API name of the field on the Thing record where the value is saved. |
Outputs
| Name | Type | Description |
|---|---|---|
| recordId | Id | The Id of the Salesforce Thing record. |
| value | Text | The value that was parsed and saved. |