Data Streams
View, configure, and enable Data Streams for channel assets
Data Stream is a data streaming framework and it can be used to receive a copy of message transactions (Incoming Events, Outbound Messages, Delivery Receipts), or Audit logs for a tenant on the configured Kafka destination.
Understanding the Data Stream Framework
The Data Stream framework is composed of the following :
- Event
- Destination
- Pre-configuration and Enablement
- Controls (Asset and Payload)
Event
Events define the data or payloads that will be forwarded to the specified destination.
Destination
Destinations are nothing but the location where the payloads of events will be sent. Webex Connect only supports Kafka (AWS & Azure) as a destination. Destinations can be pre-configured to enable default streaming of payloads from Webex Connect to the destination, or can be configured by platform users, post-enablement of Data Stream.
Pre-Configuration and Enablement
Data Streams are pre-configured by the Webex Connect Support team. Once a Data Stream is enabled for a tenant, it may or may not initiate default streaming of the data to the destination. It depends on how the Data Stream was pre-configured by the Webex Connect Support team. The Webex Connect Support team can set up the destination at the client-level. In such cases, data streaming will only commence once the destination is correctly configured within the Data Stream Management section, under the tenant's 'Integrations' area.
The pairing of Kafka Destination – Kafka Destinations requires VPC(virtual private cloud) pairing.
Controls (Asset and Payload)
Pre-configured Data Streams are enabled with events for all channels and all assets in your tenant. You can modify the asset configuration in the Data Stream Management section as needed.
A Data Stream payload typically contains three types of parameters:
- Channel Parameters: Used for channel events, or audit log parameters for audit logs.
- Pre-configured Parameters: Added by the Webex Connect Support team during the initial configuration of the Data Stream.
- User-Defined Parameters: Added by platform users as part of their configuration within the flow. Please refer to the Sending Flow Variables to Data Stream section in the lower end of the page for more on how to add parameters in the payload for messages that are exchanged via flows. Adding extra parameters like flows is not possible for the messages sent using Send Message API v1 and Send Message API v2, also if data streaming is enabled at an asset-level. In other words, the ability to add extra parameters is only available for message exchanges via flows.
Data Stream feature support
- Data Stream is supported only on the SMS, Email, Live Chat, RCS, Messenger, Apple Messages for Business, and WhatsApp channels.
- The Data Streams feature is not supported on the Azure environment.
Viewing Data Streams
A tenant can have one or more Data streams. You can view the enabled Data streams under 'Integrations'. To view a data stream on the platform:
- Navigate to Assets > Integrations.
- Filter with Data Streams.
- Enabled Data Streams will be shown in the listing, click Manage associated with the desired stream.
- The Manage Integration - Data Stream page consists of the following:
- Name
- Description
- Assets
- Enable by default for all assets
- Choose to enable at an asset-level
- Channel Events
- Other Events
- Once all the configuration is done, click Save.
Sending Flow Variables via Data Stream
Optionally, Data Streams enabled for your tenants can be selected in the Start, Send, and Receive nodes to add more context to the Data Stream payloads of Outbound and Incoming Messages. You will have to select a Data Stream in the Start, Send, or Receive nodes in the flow canvas, to be able to add more context (key-value pairs) to the payload.
To select a Data Stream in a Start, Send, and Receive nodes in a flow:
- Navigate to the flow for which you want to configure the data stream.
- Select the channel for which you want to configure the data stream.
- Navigate to the Data Stream (Optional) tab.
- Click Add Data Stream.
- Choose the appropriate integration from the list.
- Click Add Context, if you want to build context to the Send or Receive nodes.
- For Parameter Name, enter the key name and the parameter will be included as data in the notification.
- For Value, enter the flow variables or a static value. This value will be included in the notification against the parameter name. You can add multiple data streams. However, you can choose an integration to be selected only once.
- Click Save.
Configuration of Data Stream
Data Stream can be enabled either for all assets within a tenant, or for individual assets. The Data Stream configuration gives you the flexibility to enable streaming across all assets, or selectively, at the asset-level.
By default, Data Stream is enabled for all supported channels. However, you can disable streaming for a specific channel by clearing the selection under the 'Manage Data Stream' section of the platform. This will stop data streaming to the destination for the specified channel.
Enable Data Streams for Assets
Configure Data Streams for all Assets at an Integration-Level
- Log in to Webex Connect platform.
- Navigate to Assets > Apps.
- Select the desired app or number. The page contains the following details:
- Name: Contains the name of the Data Stream.
- Description: Contains the description
- Assets: Select one of the following:
- Enable by default for all assets: Select this option to enable the Data Stream for all the assets by default. You must also select the channels for which you want to enable the Data Stream.
- Choose to enable at asset level: Select this option to enable the Data Stream only for selected assets. To enable the data stream, you must navigate to the selected data stream and toggle the data stream button.
- Channels: Contains the details about the channels for which you want to enable the Data Stream for.
- Events: All the events enabled for your tenant will be displayed
Configure a Data Stream at Asset-Level
To configure the Data Stream at an asset level, you will have to enable Data Stream for the asset. The configuration to enable Data Stream at an asset-level is found in the ‘Manage Asset’ page.
To enable Data Stream at an asset-level for RCS channel, you must follow the steps below.
- Log in to Webex Connect platform.
- Navigate to Assets > Apps.
- Select the desired app or number.
- Toggle the Data Stream option to enable it at an asset level to send the messaging APIs (WhatsApp, RCS, Apple Message for Business and In-App Messaging) and receive a copy of the data from Outbound messages and Delivery Receipts for the Integration selected.
Select the required integrations from the Integrations drop-down. You can select one or more integrations using the checkboxes. Use the Select All option to select all the integrations at once. - Select the Receive data streaming for incoming messages on the asset checkbox if you want to receive a copy of Inbound messages.
- If a flow is not configured with the selected data integration - One copy of inbound message is sent to the data stream.
- If a flow is configured with the selected data integration - Two copies of inbound message are sent to the Data Stream, out of which one is from the flow.
- If a flow is configured but not with the selected data integration - One copy of inbound message is sent to the Data Stream.
- Click Submit For Approval.
Date Streams - Inbound and Outbound Messages, and Delivery Receipts
Please refer to the link for channel specific information related to Data Streams.
Duplicate Payloads
Possibility of Duplicate Data Stream Payloads – Data Streaming can send duplicate payloads to the same destination if it is configured at different levels. For example, if you have an asset or app, and enable Data Stream for that asset, while also selecting Data Stream in a Flow's Start, Send, or Receive node, there's a chance of receiving two payloads for the same incoming or outgoing message. One payload will be sent based on the asset-level configuration, and the second will include any additional context configured in the Flow's Start, Send, or Receive node.
Events in Data Stream
The list of events for which the payload is streamed via Data Stream is available for configuration under the Manage Integration - Data Stream section.
The events preconfigured by Webex Connect Support are enabled by default for the streaming at the time of Data Stream enablement for your tenant. You are only allowed to clear the selection for an event. Please make sure you understand the impact before you clear the selection of an event, as clicking ‘Save’ will prompt the system to immediately stop the streaming of the payload to the destination for the event.
To view events under Data Stream:
- Navigate to Assets > Integrations.
- Select Data Streams from the Integration Type drop-down.
- Events: All the events enabled for the Data Stream will be pre-selected. The ones that are not allowed for streaming for the Data Stream are in a disabled state.
Updated 5 days ago