2021 SmartCOMM Technical Overview
2021 SmartCOMM Technical Overview
Technical Overview
SmartCOMM brings distinct and tangible benefits to business users, communication designers,
IT teams and customer experience professionals who manage customer communications and
orchestrate customer conversations for the world’s leading enterprises.
SmartCOMM Delivers:
END USER
Voice
Web
Data
PRODUCTION Mobile
Admin System Communications
</> {;}
CRM BPM ECM EAP ...... XML JSON
</>
Content Assembly Content Management
Core Systems
Email XML
of Record
Archive
DESIGN
Print Social
SmartCOMM enables non-technical users to take control of the creation and maintenance of sophisticated customer
communications, empowering organizations to be more agile, quick-to-market and less dependent on IT resources.
Business users are able to create or apply all of the building blocks of a communication, including branding, content,
references to data items, business assembly rules and adding multiple channels. SmartCOMM supports:
• Intelligent data capture and controlled editing that • Document collaboration for the negotiation of
provide business users with the means of generating high-value documents between multiple parties,
on-demand or interactive correspondence. providing a secure negotiation environment in
These services can be easily integrated into core the cloud. A secure container, called a ‘Docbox’,
business applications that can be used to generate represents a single source of truth, containing both
correspondence throughout the customer lifecycle. the latest document version and all prior versions.
Each version has a complete ‘track change’ history
• The integration of customized business applications which attributes comments, edits and actions to
(such as CRM, policy administration systems, etc.) individuals. Changes made in external programs
across an enterprise. Once integrated, these systems such as Microsoft Word can be incorporated into
can send requests to SmartCOMM via RESTful web the collaborative document with the ability to see
services to generate correspondence immediately changes made since the last revision.
or through a batch process. They can also receive
the final output, editable communications and/or • Rapid integration through a rich and varied
status messages from SmartCOMM for additional Application Programming Interface (API). As well as
processing, if required. a broad API enabling seamless integration with the
cloud-based platform, all client-side components
• Multiple formats and multiple channels, leveraging offer their own API interface which allows them to
the flexibility of JSON and XML at its core. During the be embedded within web-based or native Microsoft
communication generation process, the SmartCOMM Windows applications (see API and Conversation
engine automatically renders the output with Cloud sections of this document for more details).
channel-specific characteristics. As a result, content It also comprises a diverse set of web services
can easily be re-used across channels, and new which can invoke discrete SmartCOMM services,
channels can be subsequently added with little covering areas such as the content management
impact. Post-processing, including job scheduling, system (CMS), communications generation, user
sorting, collation, the application of barcodes, and management and collaboration.
final output delivery.
On-Demand
For the on-demand use case, a single communication is generated in response to an incoming request. An
example of this would be the generation of a PDF quote at the end of a web application for auto insurance.
Requests are simply issued to the SmartCOMM API and a completed communication is returned in the response,
making for fluid integration with third-party applications, creating a clean, loosely coupled architecture.
A number of validated integrations exist between SmartCOMM and these customer management systems
including Guidewire InsuranceSuite®, Vlocity, Pega and Salesforce Sales, Service, Health and Financial Service
Clouds.
This use case typically applies to straight-through processing as described above, or the communication being
presented in an interactive manner for further personalization - described below. In addition, regular, high-volume
use cases are best handled by our batch service described further below.
Interactive
During customer engagement, customer-facing staff – either in a contact center, branch, or in-store environment
– need to customize or interact with the communication, before finalization, making the communication more
relevant and personalized.
SmartCOMM gives agents or other authorized users the ability to collect specific information in real time, place it
within communications and then further personalize draft communications with approved shared content as well
as direct user input before delivering to the channel of their choice. The interactive use case breaks down into two
subcomponents which can deployed together or independently.
Draft Editor is an embeddable HTML/JavaScript/CSS module that supports the interactive use case by providing
a word processor-like interface to an assembled, but not yet finalized communication. Agents, CSRs or other
authorized users can customize the communication based on their interaction with, and knowledge of, the
end customer to produce a highly personalized, on-brand communication. Critically, only those elements of the
communication that relate to the agent’s role are exposed for editing, with the rest of the communication being
viewable, but locked down to prevent other unauthorized changes. Organizations that deploy Draft Editor gain
significant benefits in reducing agent call-handling time, as the draft communication is preassembled from the
template using only those fragments relevant to the customer. Run-time choices may be provided to the user which
further reduce the time and effort to produce high-quality, and personalized communications for each recipient.
Batch Capability
SmartCOMM’s batch capabilities allow the production of high volumes of communications, typically in an end-
of-month / end-of-year processing scenario such as renewals or other high-volume applications. SmartCOMM’s
unique batch architecture empowers organizations to elastically scale up resources to meet peak demands
and mission-critical batch windows for these large batches of communications – a significant benefit over
traditional legacy on-premise or managed service offerings in the market, which require pre-provisioning of
hardware or managed service capacity to account for peak volumes yet sit idle for the majority of the time.
Collaboration within SmartCOMM addresses these issues by providing a secure negotiation environment in the
cloud. The secure container, called a ‘Docbox’, represents a single source of truth, containing both the latest version
and all prior document versions. Each version has a complete ‘track change’ history which attributes all comments,
edits and actions to individuals.
All authorized parties then negotiate on the document content, optionally adding edits, comments and
attachments until such time as the document is deemed to be finalized, at which point a final secure PDF is created
and the Docbox becomes locked down.
Documents are data-driven, meaning that they contain embedded data items, such as contract values, contract
dates and party names and addresses. Even during negotiation, the tagging of these data items is preserved,
meaning that once negotiation is complete, a downstream system can extract the values of the negotiated data
items. These can then be fed into downstream systems, such as CRM or administration systems.
All parties then have the ability to negotiate on the document content, optionally adding edits, comments and
attachments until such time as the document is deemed to be finalized. Versions of a document in mid-negotiation
can be extracted from a Docbox and updated in Microsoft Word, and then seamlessly merged directly back into the
negotiated document.
Pure Cloud
The first of its kind in the enterprise CCM market, our Pure Cloud deployment option was architected directly into
the cloud platform as a true, zero-footprint, multi-tenant SaaS service, free of any of the limitations incumbent upon
a managed service or on-premise option. Benefits of the Pure Cloud deployment option include:
Elastic Scalability - Scale to meet peak output demands without the high cost of ownership of procuring hardware
only for maximum requirements and avoiding idle utilization of resources.
Lower Total Cost of Ownership - No hardware to procure and maintain combined with the cost savings from
eliminating tech stack maintenance and installation and software/hardware updates.
Speed / Agility - The ability to bring new projects, products and innovation to market quickly and efficiently.
Higher Availability / Limited Downtime - With a blue/green deployment approach, seamless switching between
multiple production instances significantly reduces the required downtime for upgrades and enhancements.
Regional Data Residency - Choose from a number of available global data centers (including Amazon Web Services
(AWS) data centers) to meet local data regulations.
Browser-based Platform - Leverage a full-suite browser-based template design and editing experience –
eliminating the need for costly hardware and software maintenance.
Continuous Innovation - Enhanced options for customers to benefit from new innovation and releases, as well as
to select current versions to run on each tenancy.
Template
Designers Multi-tenant SaaS
Design Interactive
Content On-demand
Firewall Admin Batch
Existing
Customer
Business
Data
Applications
Payload
Web Email
Business Users
</>
XML
Voice
Archive
Figure 6 - SmartCOMM Pure Cloud Deployment Configuration Social
SmartCOMM
SmartCOMMTM
TM
Technical
Technical Overview 2020 || Smart
Overview 2021 Smart Communications
CommunicationsTM
TM
8
Hybrid Cloud
This option leverages the use of a software virtual appliance which is connected to the SmartCOMM tenancy. Our
hybrid-cloud option is designed for the needs of organizations that want to benefit from cloud template design
and testing but have stricter sensitivity or regulatory oversight over the residency of the customer data used to
personalize the communications that are generated. Benefits of the Hybrid Cloud approach include:
Controlled data pathway – Customers balance keeping customer data within their corporate firewalls with the
benefit from utilizing a cloud-based template environment.
Customer-controlled updates – Gain more flexibility and control over the upgrade cycle and cadence for the
hosted appliance.
Strategic pathway to the cloud – For customers making the move from a legacy or traditional on-premise provider,
the hybrid-cloud option can often serve as an initial, sometimes interim, step in a longer-term move to the cloud.
With the appliance, all customer data is kept within the customer’s defined security mandate (i.e. within on-premise
firewall, or deployed into a customer’s own VPC) and facilitates the hosting of all three customer communication
use cases (On Demand, Interactive and Batch).
The Appliance: The appliance is a software virtual machine supplied as a ready-to-run downloadable image that
can be deployed either on-premise or in a customer’s VPC using popular hypervisor/VPC solutions including Docker,
VMware, Amazon Web Services (AWS), Microsoft Azure, Hyper-V, Citrix Xen, and KVM. Its purpose is to handle the
CPU, network and data storage activities associated with producing output while allowing the SaaS service to manage
the configuration and provide template authoring capabilities, described in more detail in the next section.
AWS
Template
Designers
Appliance
Multi-tenant SaaS
Design Content Admin
Existing Firewall
Customer
Business
Data
Applications
Payload
Interactive | On-demand | Batch
Web Email
Print Mobile
Business Users
</>
XML
Voice
Archive
Social
SmartCOMM
SmartCOMMTM
TM
Technical
Technical Overview 2020 || Smart
Overview 2021 Smart Communications
CommunicationsTM
TM
9
Designing, Testing & Producing Communications
On-demand, interactive and batch use cases rely on services grouped into three areas: design, content and data
mapping, which are described and illustrated below.
Template Designer
SmartCOMM puts the business user in control
of content, data items and assembly rules for
templates. Accessible from a 100% SaaS-based
browser environment, Template Designer provides
authoring capability and assembly logic rules
definition. SmartCOMM guides designers through
the rules definition process, letting them select
shared content from the Content Management
System.
Template Designer gives users the flexibility to create a single template that serves multiple languages, channels,
idioms, jurisdictions and brands, all within a single template and caters for different branding to variations in the
content of the communications by applying the final look and feel only when all of the data necessary for an
individual communication has been collected and processed.
Business users are able to leverage SmartCOMM’s unique concept of Editions, which offers an intuitive mechanism
to split design components into multiple variants or layers (Editions) which will be dynamically selected for inclusion
into output by SmartCOMM at compose-time. This allows business users to create units of content which will
respond appropriately based on language, channel, idiom, jurisdiction, and brand.
Device Preview
Device Preview allows you to view exactly
what an email preview will look like on a
mobile device through the scan of a short-
lived hyperlink embedded in a readable
QR code. This allows template designers
to be able to test HTML responsive design
in real time across multiple devices.
Figure 14 – Device Preview
Smart Components
Smart Components is an extensible framework for assisting both designers and business users in creating rich and
engaging content via drag-and-drop modules. In an HTML context, they enable rich web components, including
data-aware image carousels, video and audio controls, social media toolbar, accordion widgets, lightboxes, and
sidebar menu functions to be added via drag-and-drop to a template by business users, without requiring the
users to have an understanding of the underlying technologies. Smart Components also allows formerly advanced
content or frequently-used functions to be packaged into user friendly components, available across all channels.
Specifically, Smart Components make it easier for our customers to achieve the following:
• Embed rich and engaging content into mobile apps and full HTML websites
• Deliver a more highly personalized experience via components that can be driven by data items and
wrapped in logic
The SmartCOMM CMS includes individual audit history and metadata about all the resources held within it.
Additionally, references are maintained between all of the different linked components, allowing a graphical view
to be generated for assessing the impact of making a change. The benefit of the impact analysis is the ability to
dramatically reduce the time associated with testing a new release, allowing the testing team to focus on just
templates and components that are impacted by any given change.
The CMS can also be interrogated programmatically using an extensive RESTful Web Service API. This allows
organizations to load and manage the CMS with content from other systems, which provide a content syndication
capability from Digital Asset Management (DAM) solutions.
For on-demand, interactive and batch use cases, the process starts by receiving transactional data as XML or JSON
input from an external source. Once received, the SmartCOMM engine applies processing rules to determine the
appropriate template, channel(s), language, idiom, jurisdiction and distribution mechanism for the communications
created.
On creation of the final communications from the data request, the delivery process can either be triggered
immediately or it can be invoked based upon an event, such as the number of transactions currently being held or
at a preset time during the day, week and/or month.
• Print - including Adobe PostScript, IBM AFP, PDF and Interactive PDF
• Web and Digital - including HTML, Email, SMS, Social output including WhatsApp
Because SmartCOMM is built on XML, it is well positioned to adopt and implement new channels as they emerge.
SmartCOMM generates multiple channels from a single communication request. For example, from one request, it is
possible to generate a PostScript file for print, a PDF for archive, an XML file to handshake with external systems and
an SMS message.
Post Processing
SmartCOMM’s post processing capabilities enable deliverable output to be manipulated to fit all downstream
requirements. Capabilities extended include the ability to create Mail Packs (collation of multiple documents),
Configurable Job Scheduling, Output Sorting, the inclusion of Barcodes and OMR Marks in all formats typically
expected, processed and bundled according to Print Service Bureau expectations.
SmartCOMM has the native capability to deliver content to a customer’s existing SMTP and SMTP to SMS gateways
for Email / SMS Delivery and also supports the delivery of Archive copies to a 3rd party system in a variety of
different ways.
Email/SMS Delivery
SmartCOMM leverages a customer’s current infrastructure by brokering generated e-mails and SMS message
through their existing STMP and SMTP to SMS gateways. Emails can either be HTML or plain text and can include
variable header details such as “To”, “From”, “cc”, “bcc” and “Subject”. These values are passed to the Output
Processor using channel job properties which are typically derived from the transaction data.
Archive Delivery
SmartCOMM supports the delivery of an archive copy to a 3rd party system, including all of the necessary indexing
metadata, through a custom archive handler. The metadata is specific to each document as it is derived from the
transaction data. Due to the open architecture nature of the solution, it can also be integrated with any archive
system that has an open API.
SmartCOMM
SmartCOMMTM
TM
Technical
Technical Overview 2020 || Smart
Overview 2021 Smart Communications
CommunicationsTM
TM
15
Migration Studio
Migration Studio is an additional, optional module of the SmartCOMM platform. Migration Studio is a suite of
capabilities designed to facilitate the migration of customer communication outputs to SmartCOMM templates.
The migration from legacy communication applications can be a time-consuming and arduous process, with
many manual steps as well as manual recreation of these mission-critical communication templates. Migration
Studio significantly reduces the costs, time and complexity inherent with these migrations. The suite of capabilities
empowers users to intelligently migrate mission critical customer and business communications - including
text, styling, images, and tables from legacy communications platforms - and automatically re-creates them in
SmartCOMM.
Migration Studio does more than simply recreate communications from customer output to SmartCOMM
templates. Instead, it takes advantage of the four-layer model described in Figure 20 and logically separates the
content, styling, layouts and data models, automatically creating corresponding resources in SmartCOMM or
allowing users to choose to map to existing resources. This process maximizes the re-use of the resources across
templates in SmartCOMM and significantly reduces their ongoing maintenance.
Four-Layer Model
At its core, SmartCOMM has been designed and
developed to allow business users to control the content,
data items and assembly rules for the specification of
the communication templates. This approach allows
the more technical aspects of the process–such as style
design and data model construction–to be handled by Behavior
technically-oriented users. Addressing the fundamental
problem of inefficiency in the creation and maintenance
of communications, this division of labor at the very
foundation of SmartCOMM architecture provides an agile
method of creating and maintaining the communication
templates. The resulting collaboration between the different
stakeholders ensures a much faster communications
development cycle.
When the template is presented with an individual customer XML or JSON record, it can use other metadata,
extracted from the datafeed, to determine the output format and channel. This, in turn, is used to select the
appropriate styling, layout and branding from the styleset and layout modules. Component re-usability is provided,
allowing individual document fragments – known as shared content – to be linked to a template and have their
own version control, approval and security model associated with them.
Enclosures
(Templates)
Function Library
Shared Content
</>
{;}
</>
{;}
Channel
Layout(s)
SmartCOMM
SmartCOMMTM
TM
Technical
TechnicalOverview 2020 ||Smart
Overview2021 SmartCommunications
CommunicationsTM
TM
18
Product Components
API
SmartCOMM provides one of the broadest set of APIs in the Customer Communications Management (CCM) market,
enabling programmatic orchestration of virtually any aspect of the system. APIs are packaged as RESTful web
services or where appropriate, as client-side JavaScript- based components with their own API sets. Some APIs can
be executed against the Appliance, some against the SmartCOMM cloud service and some can be executed on both.
The richness of our APIs allows SmartCOMM’s full suite of capabilities (including communications and document
editing, generation and collaboration capabilities) to be embedded in any web-based application or native client
application. APIs have been used to integrate with applications such as Guidewire®, Salesforce, Vlocity, Pega, Adobe
Sign, and DocuSign®. API integration, development, and testing can be accelerated with the use of the Swagger API
viewer included as part of the standard SmartCOMM solution and allows the use of the API to quickly emulated.
Where SmartCOMM is embedded as an embedded component in a host solution, it is typically the host solution
which provides the user authentication. SmartCOMM has adopted the SAML 2.0 standard as a basis for providing
Single Sign-on (SSO), allowing authentication requests to be deferred to a third-party provider.
AREA DESCRIPTION
A control that can be embedded within a web page. The page is used to capture
Data Capture Component data that is required by the template. After the data is captured, the XML data can be
used with the Assembly API to generate a multi-channel communication.
A control that can be embedded within a web page. The control allows interactive
Draft Editor Component editing of a draft communication by the end-user. The control is typically populated
with a draft that is generated via the Assembly API.
A collection of RESTful web services that can be used to administer users and groups
The framework provides the fabric and connective tissue between the Smart Communications portfolio of solutions
to partner-built and other third-party systems, the systems that our customers are relying on each day. In addition,
our professional services team offers validated accelerators expanding SmartCOMM’s functionality. All of our
offerings are built to live at the center of the Conversation Cloud - a cloud framework that connects all of your data,
applications, and history to build conversations that are relevant and impactful, time after time. This approach
increases internal efficiencies by breaking down silos and allows for a more complete and consistent view of the
customer.
ClaimFirst by ClaimVantage Providing an automated claims processing solution for life and health
claims for insurance carriers, third-party administrators and employers
Additionally, it provides a mechanism to allow third-party solutions to integrate their data about individual
communications into the repository providing a rich interaction history and allows real-time decisions to be made
about new communications to benefit from this insight. Performance insights can be used to hyper-personalize
subsequent communications or aggregated to uncover trends across the business.
Supporting the provision of Pure Cloud and hybrid cloud solutions, Smart Communications has implemented
a robust information security program. For deployment configurations in Smart Communications’ own cloud,
Smart Communications has attained PCI DSS Level 1 Certification for its Software as a Service (SaaS) solution. This
certification sits alongside other achievements, including:
Minimum Requirements
The most up-to-date version of our minimum system requirements can be found at the following link:
https://www.smartcommunications.com/system-requirements/
Web Browsers
Any HTML content that is generated by SmartCOMM is supported on any modern browser. The SmartCOMM user
interfaces are supported on the following browsers:
For the best possible experience of SmartCOMM, we recommend that you use the supported browsers listed above.
Screen Resolution
SmartCOMM has been optimized for screen resolutions and browser window sizes equal to or greater than
1280 x 960 pixels. The product will work on screen resolutions and browser window sizes of 1024 x 768 but the
user experience may be sub-optimal.
The following hypervisors are supported with the SmartCOMM Appliance. The Appliance requires a version of the
selected hypervisor that supports Red Hat 7:
• Hyper-V
• Citrix XEN
• KVM
• Microsoft Azure
• Docker
Salesforce Integrations
SmartCOMM™ for Salesforce is an enterprise-grade customer communication solution designed to work with
Enterprise, Unlimited, and Performance editions of Salesforce. It is also compatible with Salesforce Communities
and is Salesforce Lightning-enabled. Standard and custom objects are supported.
• Job Management - for requesting communications for on-demand, interactive and for batch requests to the
Appliance.
• Draft Editor - to collect editing analytics information such as the period of time spent editing a given fragment.
The analytics data can be retrieved via an API and further processed by a business intelligence system.
• Collaboration - to capture audit trail entries and user interactions within a document to provide insight into the
negotiation process, allowing for the identification of bottlenecks, the potential to improve base templates, or
the need for user education.
Connect with Us ment platform. More than 500 global brands rely on Smart Communications to deliver
smarter conversations across the entire lifecycle—empowering them to succeed in
today’s digital-focused, customer-driven world while also simplifying processes and
www.smartcommunications.com
operating more efficiently. This is what it means to scale the conversation. Smart
Communications is headquartered in the UK and serves its customers from offices
requests@smartcommunications.com located across North America, Europe, and Asia Pacific. The Smart Communications
platform includes the enterprise-scale customer communications management power
linkedin.com/company/smart-communications. of SmartCOMM™️, forms transformation capabilities made possible by SmartIQTM
and the trade documentation expertise of SmartDX™️. To learn more, visit smart-
communications.com.