Proactive SMS to customers

Add 2 GB Data case implementation- Proactive SMS to customers

Description	To enable clients to trigger SMS to customers proactively using Twilio account.
Version as of	8.7
Application	Pega Foundation for Communications
Capability/Industry Area	Communications and Media

Enter your topic description

This article covers the configuration and usage of the implementation for proactively sending SMS to customers on business conditions and help the clients to inform/advertise their products to the designated customers.

The implementation is done on the Pega Customer service Communications as part of Self service application shipped as "Add 2 GB data" case.

This is a use case suitable for scenarios involving sending an SMS to selected customers by the clients proactively-post checking client imposed, configurable business conditions.

Use case examples

Customers of Communications client, when exhausted, at least of 80% of their internet pack and having at least of 10+ more days of validity, will receive SMS from the client proactively encouraging them to utilize a top-up of 2GB data to be added to their usage for seamless experience, aiming for better customer satisfaction.

Before you begin

Following are the key factors to note while using this use case:

• The environment should be a DMZ enabled server.
• Sample DML is to be added.
• Twilio account should be acquired for sending the SMS from.

High level process and design:

1. .csv file is placed in the location is picked up by the file listener. As per the current implementation, it is set to '/tmp' folder.
2. File listener will consider each line in .csv file as a record and would delimit the contents of the line and queue it to the queue processor.
3. Queue processor will invoke Data transform “EvaluateSmsResponse” which constructs the customer data and the account data of the designated customer using the phone number of the customer which are needed for sending the appropriate SMS.
4. The initial SMS is sent to the customer via Twilio API to the customer number.
5. Customer, if interested, would respond back to the initial SMS with valid options available. (Buy, Add Plan, Usage, Help)
6. DM channel “Add 2GB Data” which is configured on the same Twilio account, would listen to the SMS response from the customer and would do the following:
   • For Add/Help/Usage/Plan: Would reuse and hit Data transform “EvaluateSmsResponse” to construct the customer and account related data.
   • For Buy: An “Add2GBData” case is created.
7. Pega Platform constructs the corresponding SMS reply to the customer by constructing the customer context and the account context.
8. Relevant SMS as per the response of the customer is sent out to the customer via Digital messaging channel.
9. Customer receives the constructed SMS on the details requested as per communication.
10. Steps 8 and 9 are repeated as needed/as per the SMS replies sent by customer.

Process/Steps to achieve objective

The "Add 2GB Data" use case is implemented by considering .csv file as an input file containing the list of customers who are considered for sending the SMS. The same can be further extended to utilize SOR or any other Integrations as per the requirement.

Below is the configurational aspects that are to be covered for the proper functionality of Add 2GB data case:

• Configure the Manager Key and ID of the environment in the Application definition of "PegaCSCSelfService" under the security tab.

• Validate the business conditions imposed on sending the initial SMS (proactive) to customers under configuration settings in App studio, as under:

• The number acquired from Twilio is to be setup in the filed value : ProactiveSMSFromNumber with the country code included.

• Authentication profile "ProactiveSMS" is to be configured with the right Authentication ID and key values received from Twilio.

• Ensure your File listener is configured correctly as shown below. By default, the listener is set to listen on '/tmp/' folder.

• Validate if the file listener is running on the server by switching to Admin studio under the Listener section inside the "Resources" pane.

• Resource path of Connect Rest "ProactiveSMS" is to be updated with the authentication ID received from Twilio as shown under.

• Ensure the queue processor "InitiateSmsToCustomers" is active and running.

• Ensure the System runtime context contains application "PegaCSCSelfService" of 8.7 is present as shown under.

• Ensure that the "ProactiveSMS" file listener is active and running.

• Configure the Twilio setup under "Add 2GB Data" digital messaging channel by clicking "Manage connections" under connections tab under channels and interfaces component of "PegaCSCSelfService" application as shown in series of snapshots below: (Please note that the snapshots are from v-8.7 and might vary on versions being implemented on)

• Do note the Webhook URL which should reflect same as Manager key's and ID of the Application.

• Add the country codes which are supported for receiving the response from customers to the corresponding Twilio number.

• The Number reflects when added successfully in the Connections tab of the Channel.

Limitations:

• A case gets created only when the customer responds with "Buy" in the current OOTB implementation.

• The initial SMS sent via Twilio API is not saved as part of the conversation, if case gets created. The rest of the interactions between customers is captured as part of the conversation history.

Results

The SMS conversation can be initiated between client and customers via SMS channel.

A business solution that automates workflows in your organization. Multiple, unrelated applications can be hosted in the same system. You create an application by running the New Application wizard.

Actual work that is performed by application users and automations that consists of a sequence of tasks and leads to an intended business goal. An example of a case is a process of hiring a particular job candidate, where an HR worker collects necessary documents, a hiring manager conducts a job interview, and an application sends an automated email with onboarding information after the candidate is approved. To create a case, you first build a template of your business process that is a case type, and then apply the template in multiple cases, for example, to review applications from many candidates.

A metric that measures how a case was completed as assessed by your organization. Customer satisfaction is a perception of the customer's viewpoint, unrelated to whether your organization performed the work properly or in accord with your standards or industry standards. Use the standard property Work-.pyStatusCustomerSat to record customer satisfaction.

(Deprecated) A configuration of panels (areas) in a harness that support a composite portal. Existing panel sets continue to function. As a best practice, upgrade panel sets to screen layouts.

A case in a concrete class that inherits from the Work-Folder- class. A folder object holds a collection of one or more cases, including covers and other folders, to provide access for analysis and reporting.

A work party that typically initiates a case. In many applications, only one customer can be associated with a case.

Information that is captured during the life cycle of a case.

A digital medium through which users access your application. Depending on your business needs, you can set up various channels for the same application. For example, customers can access an application for booking flights through a browser-based web channel, or through a mobile channel that relies on a mobile app. In addition, you can also build a Facebook chatbot for customers who want to ask questions about their booking. At the same time, you can set up a second, more utilitarian web channel to accommodate professional users, such as travel agents. By making an application accessible over several channels, you can reach a wide variety of audiences, and provide each user group with the most appropriate content and user experience.

A work party that typically initiates a case. In many applications, only one customer can be associated with a case.

Used to generate legacy document types. A requirement is an event, condition, or function that must be satisfied and tracked by an application. Requirements can be functional (a capability) or non-functional (a quality or constraint). One or more requirements can be used to define the criteria for the successful implementation of a specification.

The process or action of verifying the identity of a user or system. Authentication in Pega Platform ensures that only users and systems with verified identities can access resources such as web pages, APIs, and data.

The building blocks of your user interface, sections can use design templates for their structure and contain such interactive UI elements as fields, buttons, lists, and so on. A section creates a functional chunk of a user interface, and can be reused throughout your application for improved consistency and efficient development.

For example, your application may need to display user data as a list of ID cards. You can create a section for the contents of a card, and then reuse that section so that the design of every card is consistent.

A digital medium through which users access your application. Depending on your business needs, you can set up various channels for the same application. For example, customers can access an application for booking flights through a browser-based web channel, or through a mobile channel that relies on a mobile app. In addition, you can also build a Facebook chatbot for customers who want to ask questions about their booking. At the same time, you can set up a second, more utilitarian web channel to accommodate professional users, such as travel agents. By making an application accessible over several channels, you can reach a wide variety of audiences, and provide each user group with the most appropriate content and user experience.