Welcome to the Developer’s Reference Guide!
Table of contents
- Integrating communication channels brings synergies and efficiencies to business applications throughout the enterprise and makes innovative solutions possible.
- Building channel solutions has been difficult and limited to paired integrations between channels of a single provider and a single business application, best suited for contact centers.
- AMC DaVinci is a flexible cloud-based integration platform that dynamically assembles multi-point simple or complex integrations to support a best-of-breed channel strategy.
- The DaVinci SDK and API enable developers to build component apps that integrate new and legacy applications and communication channels, and to add new functionality to communication solutions.
Introducing the DaVinci Platform SDK
Building communication integrations used to require the great effort of three integrations: separate integrations into the CRM application API and the contact channel provider API, and a final complex functional integration that stitches these two systems together: building common services such as authentication and logging, weaving the interaction workflow, and reconciling real-time event-driven communication interactions with business application transactions.
Purpose and features of the DaVinci SDK
Joining communication channels with business applications together forms the foundation of powerful interaction-oriented applications. Such assemblies bring synergies and efficiencies that range from contact centers to integrated business relationship processes to enterprise collaboration. They simplify and guide common tasks to speed customer interactions. They coordinate information and actions to speed knowledge workers in their efforts. They capture details and trends in business processes and relationships throughout the enterprise. They make possible new, previously unanticipated or impossible solutions, such as bots that automate common business interactions, whether simple or complex.
But developing these integrations is difficult. It requires skills in traditional computing languages, arcane real-time, event-driven, and multi-threaded programming techniques. Developers must have sophisticated domain knowledge of the application, the integrated communication channel, and the contact center and collaboration processes.
It is a narrow and expensive group of developers who have the skills to do all that.
Today there is a great need to open up the contact center to broader commercial and bespoke functionality. Integration complexity becomes a barrier to new CRM / CSM application vendors and channel providers. It becomes a costly impediment to systems integrators and enterprises who wish to integrate legacy applications or diversify integrated communication throughout the enterprise, to innovative automated and collaborative solutions, and to industries with sophisticated customer interaction workflow requirements (such as telemedicine).
Those unwilling or unable to assume the cost and effort of building integrations are orphaned in the marketplace. And those who do assume the burden of custom integrations are trapped into the narrow set of application and communication channel vendors they have selected.
The entire consumer community suffers because dominant vendors leverage this integration complexity to impose their hegemony on the application and communication channel markets.
Overview of DaVinci
AMC DaVinci is a flexible contact center solution platform. It unites communication channels with business applications within a single application browser session, “a single pane of glass.” It may be deployed in the cloud, on premise, or in hybrid configurations, with cloud and premise components.
The power of the DaVinci platform lies in its distributed, component web architecture. Instead of implementing tightly coupled paired integrations, customers assemble solutions from the DaVinci ecosystem, a growing collection of autonomous apps integrated into the DaVinci Framework.
Each independent app is a web application responsible for discrete functionality. CRM application apps integrate business applications; channel apps integrate contact channel providers, etc.
Apps can add functionality to the solution. They can incorporate external data sources. They can perform common services such as coordinated presence, or common tasks such as speed dial. They can bring new capabilities such as acting as agent assistants presenting scripts or recommending knowledgebase resources. In the future they may serve as single-purpose or artificial intelligent bots, automated agents.
Developers no longer need to create a complete contact channel integration. They need only incorporate their functionality through a DaVinci app component.
How the DaVinci Platform works
Before delving into the API and integration effort, let’s first understand how DaVinci works; how it uses the web development stack to simplify and expedite communication integrations.
DaVinci Agent is a container, a single-page application, that does three things:
- It presents the user interface, the agent toolbar (softphone).
- It serves the core services and message broker of the Framework integration engine and the DaVinci API.
- It hosts solution apps, each within its own iframe.
Figure 1: DaVinci Agent web application
DaVinci uses web development stack iframes and cross-window messaging to maintain the integrity of the solution. Iframes give each app a private display space while isolating and securing their processes. Cross-window messaging glues them together, sharing events and information, into a gestalt solution.
Table 1: DaVinci foundational components
|Component||Role and Use|
|DaVinci Agent||Agent is a single page web application. It is a container which hosts the integrated solution: the DaVinci Framework and the deployed solution apps.Agent itself is hosted by a CRM application as the integral toolbar within an application iframe. (For example, Agent is configured into and launched by Salesforce Open CTI as its “softphone.”) Agent may also be accessed directly, through the agent.contactcanvas.com URL for testing, or deployed as a stand-alone toolbar or multi-application user interface.|
|DaVinci Framework||Framework is the backbone of the integration. It consists of core services, housekeeping services, the message broker and the DaVinci API. Each is described more completely here.|
|Core Services||Core services are inherent functionality that reduces the effort of building apps and handles the complexity of transforming real-time event driven systems into transactional apps. As shown in Figure 1, it handles events and data sharing, manages security and user authentication, enables app logging, effects the interaction workflow, etc..|
|Housekeeping Services||Housekeeping services maintain the DaVinci application. They display the agent login page on startup, authenticating users within the DaVinci platform; retrieve user solution configurations; dynamically load apps into their iframes; and handle the shutdown of apps and the agent user session.|
|Message Broker||Message broker distributes messages to subscribing apps. Messages bind the decoupled apps together. All actionable functions, tasks and information, are converted into and raised as messages. Message broker receives the actionable messages raised by an app and broadcasts them to all subscribing apps.Apps subscribe for messages by registering with message broker. Each message registration passes in an event handler callback function reference invoked by the message broker.|
|DaVinci API||Application programming interface that enables functional development to integrate real-time, event driven services. consisting of classes, interfaces, enumerations and functions used to integrate into the DaVinci Framework.|
Customers assemble their solution by selecting and configuring apps within the Creators Studio administration utility. On login, Agent authenticates users, retrieves their solution and dynamically launches each app from its web site into its hosted iframe, passing in configuration settings. Once initialized each app registers for the messages of its supported events. The solution functionality spans across its assembled apps, aggregating into operations, interactions and activities bound by message flows: ordered message exchanges.
Message flows and functional processes
This makes DaVinci a message driven platform. Apps raise messages on internal and external events, on state and information changes, and to request actions. Message broker receives and broadcasts the messages to subscribed apps. Apps respond to their supported messages by executing actions and by relaying results and information as new messages. These message exchanges organize flows of common functional processes such as executing click-to-dial, receiving and handling an inbound call, and maintaining and tracking a customer interaction.
Sequential flow diagrams clarify the transcending processes, identifying the participating apps and external services, and breaking down and ordering the constituent messages and actions of the flows. It’s important for developers to understand these diagrams. They help identify the roles and responsibilities of each app. They layout the sequential order of the process: the triggering events or requests, and the actions performed, or functions executed.
Below is an annotated example of a sequential flow diagram for click-to-dial.
Example sequence flow diagram – Click-to-Dial
Click-to-Dial is a process that executes a dial when a user clicks on a phone number link within the CRM application. Figure 2 shows the sequential flow diagram for click-to-dial.
Boxed across the top are the participating solution components, from left to right:
- channel – the communication channel, here a voice platform, typically a PBX;
- channel app – the hosted channel app that integrates the channel with DaVinci;
- DaVinci – all DaVinci Platform components, the API, the framework, message broker, etc. are represented as the DaVinci “black box;”
- CRM app – the hosted CRM app that integrates the CRM application with DaVinci;
- CRM application – the integrated CRM application, which typically hosts the toolbar in its iframe.
- Not represented – the user working within the application and the telephone network
Figure 2: Click-to-Dial sequential flow diagram
The box represents the integrated solution domain, everything outside the box is an external event or action. The vertical lines demark the boundaries between the solution components, each aligning with the labeled component above the lines. The dashed horizontal line indicates precursor processes, here the channel app must register for the DaVinci click-to-dial event messages. The horizontal arrows represent the solution events, actions and messages. The arrow direction indicates the process flow, and the vertical staggering indicates the process sequence. (For simultaneous occurrences, the arrows would be aligned instead of staggered.)
Reading this process execution is as follows:
• As a precursor to click-to-dial, the channel app registers with message broker to subscribe to click-to-dial messages – registerClickToDial() – passing in its callback function.
• A user (external) working within the CRM clicks on an application link to place a phone call dial request;
• The application invokes its click-to-dial API to the integrating CRM app function;
• The CRM app invokes the DaVinci API clickToDial() function, which propagates within the DaVinci framework, message broker broadcasts the event message to all subscribing apps through their callback functions;
• The channel app callback function, invoked by message broker, executes the channel API make call function to dial the call;
• The channel executes the dial.
Preparing yourself and your development system
With this background, you should be comfortable developing a DaVinci app. In my next posts, I will explore the DaVinci SDK by stepping through the sample channel and CRM app source code. But first you must prepare your development environment to follow along with that discussion.
You should feel comfortable with the list of skills in Table 2: DaVinci App Development Skills. Truth is, if you have the core web application knowledge and know what the rest are, you should be able to follow along and appreciate the effort necessary to build a DaVinci app. You will also need to prepare your development machine, downloading and installing tools and source code (see Table 3: Development Tools and Utilities).
You should also understand how to use these common and popular web development tools: node.js, npm package management, git and GitHub. If you haven’t used them before, they are easy to install and understand.
Table 2: DaVinci App development skills
|HTML5||Displaying app information within the Agent Toolbar.|
|CSS||Formatting display of app information within the Toolbar|
|Development framework: AMC uses Angular and React||Simplifies web development effort. They handle things such a promises and observer patterns.|
|Node.js||Run apps as web application under node.js.|
|npm package management.||Package resources are accessed through npm|
|GitHub and git.||Public and enterprise and personal version control system. AMC publishes code examples to GitHub.|
Resources – installed on your development machine
DaVinci apps are web applications. They run under node,js. You must install node.js on your development machine. Development resources are distributed through npm package management. Although npm is included with node.js, you should update your npm after installing node.
You should use a version control system. Most web developers use git for local repositories and GitHub to publish their code. AMC uses and recommends both. We publish our code samples through our public GitHub repository. You will download the sample app source from GitHub.
You will need a source editor. AMC uses and recommends Visual Studio Code IDE with added packages to support for TypeScript, git and other common utilities.
Finally, development frameworks such as Angular and React save time and reduce effort. You should be familiar with Angular and React, at least enough to read and follow along their use in the sample code apps.
Table 3: Development tools and utilities
|npm||Yes||6.9.0||https://ww w.npmjs.com/get-npmupdate [after installing node.js]: npm install npm@latest -g|
|TypeScript||Recommended||Latest||npm install -g typescripthttp://www.typescriptlang.org/index.html#download-links|
|Visual Studio Code||Recommended||Latest||https://code.visualstudio.com/download|
|Angular CLI||Recommended||Latest||npm install -g @angular/clihttps://angular.io/|
There are two SDK resources. The DaVinci API documentation, which you may open in the browser window. And the sample app source, which you will retrieve from GitHub.
|SDK Resource||Location||Special Instructions|
|DaVinci API documentation||http://apidocs.contactcanvas.com/||Click on the link, open the document.|
|Sample CRM App||https://github.com/amctechnology/SampleCrmApp||See below.|
|Sample Channel App||https://github.com/amctechnology/SampleChannelApp|
To retrieve a copy of the source code. These instructions will duplicate the repository source directories within a named subdirectory.
1. Follow the link to GitHub in Table 3. This will open the AMC GitHub repository for the sample app.
2. The repository should look like Figure 3: GitHub Repository. If it looks different, click on the “Code” tab (upper left).
Figure 3: GitHub repository
3. Use the green Clone or Download button to retrieve a copy of the sample app source.
a. If you have git on your development machine, clone the repository.
i. Click the clipboard icon to copy the URL (see Figure 4).
ii. Open a command prompt window, navigate to your development directory and enter the “git clone” and paste the repository URL.
iii. If you clone the repository, the source directory will be named either “SampleCRMApp” or “SampleChannelApp.”
b. If you do not have git, download the zipped distribution.
i. Use the Download Zip button to download a zipped distribution of the source code (see Figure 4).
ii. Save the zip file to your development directory
iii. Then extract the source directories.
iv. If you extract the zipped download, the source directory will be named “SampleCRMApp – Master” or “SampleChannelApp – Master”. And the actual source directory may be in a second identically named subdirectory. You will want to clean this up.
Figure 4: GitHub clone or Download zip
Self-Start Kit documents include how to and reference guides, sample applications, user stories and use cases.
Samples, code snippets, templates and open source for all AMC DaVinci apps mean you don’t have to “start from scratch.” Dive right in to build your own app or extend AMC’s DaVinci apps with new features and custom flows.
Question, suggest, answer, vent. You are not alone. The DaVinci Development Community provides the fellowship and support you need to grow and succeed.