Setting up a Case Update Rule triggered Social DM distribution

Updated 

This article describes how to create and configure a Social DM Distribution for sending survey invitations within private social care conversations in Sprinklr Service. The distribution defines the survey invite, delivery settings, and scheduling for post-care feedback. Creating the distribution is a required step, but surveys are sent only after a rule is configured to trigger the distribution based on defined social care conditions.

Business Use Case

You can refer to the overview article for more details on use cases and value additions.

Social DM Distribution enables context‑aware feedback collection by triggering surveys directly within active social care conversations, ensuring relevance and continuity. It offers centralized distribution management, with Social DM distributions configured and monitored from the same Distribution RM used across other channels. Additionally, it provides actionable distribution insights, with built‑in metrics that track invite delivery, engagement, and survey completion to give teams full visibility into post‑care performance.

Prerequisites

To access the Email Distribution, you must have the following View and Edit Distribution permissions at the Survey Level.

Setting Up Social Direct Message

Navigation steps are enlisted below.

  1. Go to the Customer Feedback Management Persona App and then access a Survey.

  2. Once you open the survey, click Distribution.

  3. Go to Create Distribution and then navigate to Social.

  4. Select Social Direct Message (DM).

  5. Go to the Details section and fill in the details:

    1. Distribution Name: Provide a meaningful name to the distribution.

    2. Distribution Description: Enter a description of the distribution.

    3. Survey Format: The survey format selected will be Standard Survey, and click Next.

  6. Go to the Creative section and fill in the details:

    1. Social Media Platform: Select a social channel from the drop-down.

    2. Invitation Creative: You can select an invitation creative or create a new creative inline and click Next.

      You can Preview the survey invitation after selecting it.

      Creatives created inline during distribution setup are automatically saved in the Creative Library for reuse.

  7. Navigate to the Translation Conditions section and establish guidelines for sending messages in the correct language according to the recipient's characteristics. To determine the distribution language, you can set a condition by choosing from Profile or Case Custom Fields, along with their corresponding operator and value. If there isn't a condition that fits, the message will be sent in the survey's default language. Ensure that translations are set up prior to sending the message.

    Navigate to the Language section and choose the language that has been selected and published for that survey from the drop-down menu. You can click + Translation to add new languages aswell and click Add and define the condition and click Next.

    Note: When translation conditions resolve to a specific language, the survey link opens in the same language as the invite; if no language is resolved, the invite is sent in the base language and the survey opens in the browser language; and if the browser language cannot be determined and no translation conditions are defined, both the invite and the survey default to the base language.

  8. Go to Scheduling section and fill in the details:

    1. Go to Survey Link Settings and fill the details:

      1. Start Date and Time: You can select a date and time. If no specific time is selected, the survey will collect response once the distribution is created.

      2. Expiration Type: You have the option to determine the duration for which the survey link will be valid after distribution. Choose either "Static" or "Dynamic" from the provided menu.

        1. Static: You can set a fixed expiration date and time, after which the survey link will no longer be accessible.

          1. End Date and Time: You can select the end date and time.

          2. Limit submissions per respondent: You can activate or include permitted submissions. Additionally, you can control the submission restriction per respondent by enabling or disabling it, and you can also define the maximum number of submissions each respondent is allowed. By default, each recipient is limited to a single response.

            Furthermore, you have the flexibility to enable or disable the resetting of the submission limit following a set time, and you can adjust this limit according to the number of days.

          3. Reset limit after time interval: You can also adjust the reset limit after a specified time interval to refresh the limit and include the frequency.

        2. Dynamic: Dynamic Expiry calculates the expiration time for each respondent's survey link individually, based on when they receive it. For example, if a dynamic expiry of 1 day is set and a respondent receives the link at 10 AM on June 4th, the link will expire at exactly 10 AM on June 5th, regardless of when the distribution was initially created. This feature offers precise control over response windows and can be configured within the survey settings, allowing you to set the survey to expire relative to the send time, thus guaranteeing each recipient the same response period.

          1. Expires After: You can select the expiry time and frequency.

          2. Limit Submissions per respondent: You can either enable or disable the restriction of submissions per respondent, and you can also set the maximum number of submissions allowed for each respondent. (By default, each recipient is limited to one response.)

            You have the option to enable or disable the resetting of the submission limit after a specified time interval, and you can configure the limit in terms of days.

            1. Allowed Submissions: You can add the number of allowed submissions.

          3. Reset limit after time interval: You can also adjust the reset limit after a specified time interval to refresh the limit and include the frequency.

    2. Navigate to Distribution Tagging where you can pre-fill any survey response field for all response that would be received from the survey link sent through this distribution. This helps in analytics and response workflows. You can configure multiple fields using the plus icon.

      Note: Social DM Distributions support trigger‑based scheduling only, with no other scheduling types available. Sender account selection is not required, as surveys are automatically sent from the same social account used in the care conversation, ensuring seamless and consistent delivery.

  9. Click Go to Rule Engine by clicking the pop-up. This distribution type can only be triggered through Case Update Rules by selecting content as “Case Update".

  10. Click + Create New Rule to create a rule and use it for this distribution. You need to configure the CFM survey with the appropriate condition as an action within the Rule Engine. To ensure this step is completed, the system will provide helpful nudges directing you to the Rule Engine so you can add the required CFM action.

CFM Survey Conditions

You can configure CFM survey conditions in the Rule Engine before triggering other actions based on the invite status, response status, or time elapsed since a survey invite was sent. Steps to Configure a CFM Survey Condition are as follows:

  1. Click the + Option and select Add Condition.

  2. In the Edit Condition page fill in the details:

    1. Name: Add a meaningful name to the condition.

    2. In the right-hand pane, go to Conditions Applies to CFM Survey.

    3. Select one of the following condition types to trigger follow-up actions.

      Condition

      Configuration

      Survey Invite Status

      Fields to configure:

      • Invite Status: Choose one of the following options:

        • Failed

        • Quarantined

        • Suppressed

        • Invite Sent

        • Unsubscribed

      • Survey: Select the survey for which the invite status will be checked.

      • Distribution Channel: Select Social DM

      • Distribution: Select the Social DM distribution whose invite status should be evaluated.

      Survey Response Status

      Fields to configure:

      • Response Status: Choose one of the following options:

        • Not Started

        • Survey Opened

        • In Progress

        • Partially Completed

        • Completed

      • Survey: Select the survey for which the response status will be checked.

      • Distribution Channel: Select Social DM

      • Distribution: Select the Social DM distribution whose response status should be evaluated.

      Survey Last Sent Before Duration

      Fields to configure:

      • Time Delay: Specify the duration (in seconds, minutes, hours, days, weeks, or years).

      • Survey: Select the survey for which the delay will be applied.

      • Distribution Channel: Select Social DM

      • Distribution: Select the Social DM distribution whose timing will be evaluated.

CFM Survey Actions

After establishing your survey conditions, you have the ability to set up Rule Engine actions. These actions will automate the sending of survey invitation messages, which are triggered by case events and guided by evaluation logic. Here are the steps to configure a CFM Survey Action:

  1. Click the + Option and select Add Action.

  2. In the Edit Action page fill in the details:

    1. Name: Add a meaningful name to the action.

    2. In the right-hand pane, go to Actions to CFM Survey.

    3. Select Trigger Survey Invitation action:

      Action

      Configuration

      Trigger Survey Invitation

      This action sends the survey invite automatically when defined case conditions are met.

      Fields to configure:

      Mandatory Fields

      1. Survey: Select a survey to trigger Social DM distribution. (Only surveys owned by the user or shared with “Edit Distribution” permission are available.)

      2. Distribution Channel: Select Social DM

      3. Trigger Based Distribution: Select the Social DM distribution.

      Optional Fields

      Survey language conditions i.e. Survey language, Survey Language is Last Associated Message's Language within the rule engine overrides the translation conditions set up within the distribution. If the condition is not added in the rule engine, the existing translation conditions in the distribution setup will be considered.

      • Survey Language: Select a language in which the survey is to be triggered.

      • Survey Language is Last Associated Message’s Language: Auto-detect the recipient’s last message language and trigger survey in that language.

      Following fields are not Applicable for Social DM as surveys are sent with the same account on which conversation was going on:

      • Case Custom Field for Recipient

      • Profile Custom Field for Recipient

      • Use Distribution Configured Account

How to use it?

After setting up and turning on Social DM Distribution, surveys are automatically sent out according to the criteria set in the social care process. You can handle and keep an eye on these distributions from the main Distribution Record Manager.

To validate a Social DM Distribution, first ensure there is an active test case available for the social channel where the survey will be distributed. Then trigger the configured workflow or rule on that case and verify that the survey invitation is delivered within the same DM thread, the survey link opens correctly, and the distribution metrics are updated accordingly.

Record Manager Columns & Metrics

Refer to these article for details on the columns and metrics available for Social DM distribution.

Distribution Level Quick Actions

Action

Permissions Required

Description

View

View distribution

View distribution in read only mode

Edit

Edit distribution

Edit distribution configuration

  • Distributions can be edited in all statuses except in active status.

  • All fields can be edited in Draft and Expired status

  • All fields can be edited for Paused status. However, the changes to survey invite will reflect only for any newly triggered surveys.

Delete

Delete Distribution

Delete a created distribution

  • If an active distribution is deleted, the user proceeds with deletion, the distribution selection will be cleared from the rule, and no further surveys will be triggered from it.)

  • Deleting a distribution does not delete the responses collected through it.

Clone

Edit distribution

Clone a distribution.

Pause/Pause All

Edit distribution

The pause feature allows you to stop the distribution immediately if issues arise, halting any further invites from being sent.

Note: Response collection will be temporarily halted, and recipients attempting to access the survey will be redirected to a "Paused" page until the distribution is resumed.


Best Practices

  • Trigger surveys only after the customer issue is fully resolved to ensure feedback is timely and relevant.

  • Keep the survey invitation message short and conversational so it fits naturally within a DM conversation.

  • Always ensure the customer has initiated the conversation, as Social DM surveys cannot be sent otherwise.

  • Include an opt-out option where possible to respect customer preferences.

  • Configure appropriate expiry dates and submission limits to avoid collecting outdated or duplicate responses.

  • Test the distribution in a controlled or low-volume workflow before activating it broadly.

  • Monitor invite failures, engagement, and completion metrics regularly to identify and address issues.