To pull business information from your customers connected apps you need to provision an account to store their data, display a menu of applications or data types to connect to and then get their permission to access data. You can use the server-side API to pull the business information you need immediately or prompt the customer for further information mapping and reconciliation depending on your use case. All of this functionality is contained within our Dock Link SDK.
Example Integration Flow:
In order to access data you need to decide what type of data you want your user to provide and then display to them a list of app connection options that deliver the data. Data types and example data sets include:
Financial ratios and probabilities
Subscriptions (inc recurring payments)
Human Resources (tag:
Customer Support (tag:
Queue depth and response time
Contact handle time and time to resolution
Marketing & Analytics (tag:
Advertising click through rates and CPA
Pipeline stages, value and probability of close
Time to close
Project and task information
Developer Tools & Cloud Infrastructure (tag:
When embedding the link connection widget a set of tags (comma separated) can be provided to limit the list to the types of information required.
To connect a customers business application software to DataDock you first need to get their permission to access their account by connecting the App. Once the App is connected you can make subsequent API calls to gather data.
The following steps are outlined if you are building a UI from scratch and won't be using our Dock Link SDK (see below).
Obtain a domain and basic auth credentials by provisioning a new customer account (either manually or via API request). When you first create an account you will be provided with an API user, and an associated API key, this can be used to create an authenticated request.
Redirect the users browser to: https://
a. The (
customerdomain) should be replaced with the account subdomain you have created
b. The (
integration) should be replaced with the integration key, this is a unique identifier within DataDock for each 3rd Party software integration
d. The (
yourURL) is the base64 encoded URL you would like the user to be redirected to post authorization process, typically this would be a return URL within your application service.
(optional) The user may be prompted for further information via a form. For example when using Chargify an account subdomain is required (this can also be specified upfront in the auth request if you collect the info and pass it along in the request)
User is redirected to 3rd party app (e.g. Salesforce, Quickbooks) with correct requesting information
User grants permission and is returned to Boss Insights temporarily and then is transparently redirected back to your application
Authenticating to Boss Insights to connect an App uses a Base64 encoded user/pass combination over https
With the user now having completed the connection process and returned to you application you can begin to use the server-side API to request data.
Using the Dock Link SDK
Dock Link will list all supported Apps (by name or data type) and handle credential validation, multi-factor authentication, and error handling for each app that we support. Dock Link works across all modern browsers and platforms including mobile (iOS, Android) and web) and automatically handles many of the implementation details of the Step-by-step mode(see above).
.DockLink_AppList CSS class. This DIV tag will contain the application listing and is customizable via a number of data-* attributes.
The SCRIPT tag:
The DIV tag:
<div class="DockLink_AppList" data-type="accounting" data-callback="https://myapp.com/return-page?param=1"></div>
.DockLink_AccountMapping CSS class. This DIV tag will contain the users chart of accounts and a list of your accounts they can map to.
The SCRIPT tag:
The DIV tag: