Donky Technical Overview This document will provide the reader with an overview of the features offered and technologies used with the Donky Messaging Network. This document will give a good base level understanding when reading the more in-depth documents about Donky. Contents Donky Technical Document... 1 What is Donky?... 2 NaaS Network as a Service... 3 Donky Messaging Network... 3 Server Side Integration... 4 Integrators API... 4 Forwarding API... 4 Client Side Integration... 5 Plug and Play SDK... 5 Customisation... 6 Donky SAAS Tools... 6 Donky Campaign Builder... 6 Donky Control... 6 Technical Architecture... 7
What is Donky? Donky is the only two-way app engagement network available today. Donky allows you to deliver high impact cost effective rich HTML 5 based messages into your app to engage your user base, and crucially allow your user base to communicate with you and optionally amongst themselves using Donky s inbuilt social network. Accessing a network for your in-app communications means: Cost effective communication Rich messaging and attachment support More user engagement Complete consumer communications visibility In depth analytics Integration of your CRM system and Donky for seamless omni-channel approach Easily integrate Donky into your app using our simple SDK; which will enable your app to: Receive Simple Push Messages, Rich Messages (HTML) and Two-Way Chat Messages (with attachments) Fully pre-coded UI to allow simple bolt in approach Highly customisable UI, including theme support and inheritance Highly configurable; make the SDK work the way you want it Full solution out of the box featuring: SaaS based advanced campaign tool to start effective marketing and messaging to your user base immediately, called Campaign Builder Simple bolt in mobile SDK to Donky enable your app in hours Comprehensive reporting and control of your private network partitions with our admin portal Donky Control Secure, high volume private network partition
NaaS Network as a Service Donky Messaging Network The Donky Messaging Network has been designed to provide secure, guaranteed delivery of data and messaging between millions of Donky enabled apps whilst minimising the cost of service. Multi-tenant architecture to allow many integrators to utilise the Donky network safely with encapsulated data and rigorous security. Advanced integration options for external systems to allow bulk messaging sending via the Donky Messaging Network, close monitoring for security, centralised client configuration and reliable asynchronous forwarding of events to your systems. Messaging support for: Simple pushes Chat messages Rich HTML content Attachment support for HD images Guaranteed delivery messaging architecture Organic group chat Windows Azure based technology, utilising asynchronous queuing architecture for resilience and scalability Linear scaling architecture Resilient SOA architecture Client SDK is designed for rapid integration and easy customisation SDK support for: Android 2.3 upwards ios 6 upwards Windows Phone 8 upwards (coming soon)
Server Side Integration Donky offers extensive integration options to allow powerful and flexible solutions to be created with minimum time and effort. Donky utilises industry standard protocols, encoding schemes and security to ensure ease of adoption and wide support across multiple platforms and languages. The integration facilities available are as follows: Integrators API Provides all the functionality for external systems integrating to Donky including our own Campaign Builder SaaS tool, therefore ensuring our APIs are fit for purpose and ready for enterprise volumes. The integrators API has the following characteristics: All inbound calls to the Integration API s will require the clients to use the HTTPS protocol, therefore securing the web traffic with SSL (Secure Sockets Layer) API s available for both inbound and outbound, simple, chat and rich message support JSON and XML REST support for maximum compatibility Secured using Integration API Keys (secrets) Bulk batch based messaging methods with buffering for speed Forwarding API Donky has a comprehensive asynchronous forwarding system to pass information about events occurring within your private Donky network partition to any configured external systems. The events that can be forwarded include: Message notifications o Inbound message o P2P message sent (optional) o Message receipts
o Message forwarded Administration notifications o User registered o User details updated o User unregistered o User tag choices updated o User exceeded anti-spam throttling o Etc The forwarding systems allows you to configure how we batch events up to your systems allowing you to tune the system to match your systems. The forwarding system also utilises a robust retry scheme ensuring that we will back off and reduce volumes if we encounter issues, and rest assured that we will deliver any pending notifications once your systems are available again, so no need to notify us of downtime. All forwarding notification types can be forwarded to a single reception web page, making integration straight forward. The reception web page will be used to push the forwarded events to your systems. Client Side Integration Plug and Play SDK The mobile SDK s are designed to allow existing mobile app (application) owners to quickly and easily embed the Donky Messaging functionality. The goal of the SDK is to embed the mobile components with as little effort as possible; the default mobile solution is to provide all the required backend processing to successfully interact with the Donky Messaging platform, as well as providing embeddable UI for the following: List of received rich in app messages Viewing of rich in app messages List of two way chats (Optional) Viewing of an individual chat threads (Optional) Contacts list, of known contacts also with the app (Optional) The developer is able to choose whether to enable the two way chat functionality and whether to enable the social messaging aspects by enabling the contacts list. In addition to choosing what functionality to use they have a choice of default skins to choose from, to help the Donky Messaging client UI blend with their existing app without explicit customisation work. The mobile SDK s utilise the network mobile integration API to perform synchronisation with the network, and it has the following characteristics: REST based using JSON encoding for efficiency
HTTPS 1024 bit encryption to protect messaging content Secured using: Client API Keys (secrets) oauth tokens (After login to optimise authentication performance) Customisation The developer may choose they require a bespoke integration in order to create a bespoke UI. If they choose to do this there are the following implementation paths: Create a custom skin to use with the Donky Messaging client SDK o The Donky Android utilises UI fragments to make creating custom layouts simpler Create custom screens and plumb into the SDK using events and methods; essentially re-implement the provided UI SDK support for: Android 2.3 upwards ios 6 upwards Donky SAAS Tools Donky Campaign Builder Campaign Builder is our SaaS campaign tool we provide for free allowing you to communicate effectively using messaging campaigns using either Simple Push Messages, Rich Messages or Chat Messages. It is designed to allow you to easily segment your user base and deliver targeted messaging with ease. Some of the many features it offers are: Enterprise scale campaigns Automated campaigns using schedules and FTP triggers Automated CRM integration using: o Automated FTP imports to update custom field data on contacts o Automated reporting delivered via FTP Just in time campaign deployment Powerful rules engine for automated responses Opt out of communications support Full WSYWIG adaptive layout HTML 5 editor to make making rich content messages for multiple devices resolutions simple Full inbox In depth reporting and statistics Donky Control Donky Control is the administration portal which is used to gain access to Campaign Builder and monitor
and configure your private Donky network partitions (App Spaces). Some of the features offered are: App Space configuration and setup Detailed reporting to monitor the individual Application spaces or what s happening at a global level Detailed client information and diagnostic tools to help with debugging issues in deployed devices Access to our knowledge base and support Access to downloadable resources such as documentation and SDK s Etc Technical Architecture Donky is designed to for enterprise class performance and scale and utilises the following technologies and patterns: Service Orientated Architecture Provides scalability via breadth Redundancy support Encapsulation and easy reuse Secure Least Privilege principles Token based security to avoid key transmission HTTPS protocol access to web sites mandatory Minimised surface area to reduce attack vectors Key rotation support Performance orientated Dynamic scaling platform Optimised to utilise multi-threading Concurrent access to data optimised using partitioning and advanced data locking techniques Asynchronous processing Buffering and batch processing techniques Caching wherever possible Technologies Support for JSON or XML REST 1024 bit SSL to secure communications Cloud based for scale