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 :

  1. Event
  2. Destination
  3. Pre-configuration and Enablement
  4. 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 Webex Connect admins. 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 admin. Webex Connect admins 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:

  1. Channel Parameters: Used for channel events, or audit log parameters for audit logs.
  2. Pre-configured Parameters: Added by the Webex Connect admin during the initial configuration of the Data Stream.
  3. User-Defined Parameters: Added by platform users as part of their configuration within the flow.

📘

  • 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

When the Admin enables a Data Stream for the tenant, you can view the data stream under the integrations type. After completing the configuration, users can either use the Data Streams at a Send-and-Receive node, and optionally add context to the data, or enable the data streaming at an asset-level to receive all the messages exchanged via an asset. Configuring the data stream at an asset-level takes away the ability to add additional context to the payload.

📘

Note

  • Data Stream is supported only on the SMS, Email, Live Chat, RCS, Messenger, Apple Messages for Business, and WhatsApp channels.
  • Data Integrations is decoupled from Pre-built integrations in 6.4.0 and is available as a standalone feature.
  • The Data Streams feature is not supported on the Azure environment.

To view a data stream on the platform:

  1. Navigate to Assets > Integrations.
  2. Filter with Data Streams.
  3. Enabled Data Streams will be shown in the listing, click Manage associated with the desired stream.
  4. The Data Stream Manage page consists of the following:
    1. Name
    2. Description
    3. Service
    4. Flows
    5. Rules
    6. Tenant Identifier
    7. Validate Signature
    8. Data Stream
    9. Authorization
    10. Data Stream
  1. 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:

  1. Navigate to the flow for which you want to configure the data stream.
  2. Select the channel for which you want to configure the data stream.
  3. Navigate to the Data Stream (Optional) tab.
  1. Click Add Data Stream.
  2. Choose the appropriate integration from the list.
  3. Click Add Context, if you want to build context to the Send or Receive nodes.
  1. For Parameter Name, enter the key name and the parameter will be included as data in the notification.
  2. 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.
  3. 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

  1. Log in to Webex Connect platform.
  2. Navigate to Assets > Apps.
  3. Select the desired app or number. The page contains the following details:
    1. Name: Contains the name of the Data Stream.
    2. Description: Contains the description
    3. Assets: Select one of the following:
      1. 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.
      2. 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.
    4. Channels: Contains the details about the channels for which you want to enable the Data Stream for.
    5. 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.

  1. Log in to Webex Connect platform.
  2. Navigate to Assets > Apps.
  3. Select the desired app or number.
  1. 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 drop-down. You can select one or more integrations using the checkboxes. Use the Select All option to select all the integrations.
  2. Select the Receive data streaming for incoming messages on the asset checkbox if you want to receive a copy of Inbound messages.
    1. If a flow is not configured with the selected data integration - One copy of inbound message is sent to the data stream.
    2. 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.
    3. If a flow is configured but not with the selected data integration - One copy of inbound message is sent to the Data Stream.
    4. 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 admin 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 clear the selection 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:

  1. Navigate to Assets > Integrations.
  2. Select Data Streams from the Integration Type drop-down.
  1. 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.