Connecting And Using Your First App

About this tutorial

Octoboard helps you access and visualize your cloud data. It does so by connecting to your favorite applications and using over 200 templates built for online client portals, office TV screens and automated email reports sent to clients and team members.

This tutorial will show you how really easy it is to use. We hope you will join thousands of companies who save time, share data with internal teams and delight customers with Octoboard.

In this tutorial, we will show you how to connect a single widget, add a dashboard and generate a report using pre-configured reporting template. Some screens in this tutorial use Xero.

The process of connecting and using other applications is exactly the same. You can connect your Social Networking app, Email Marketing automation tool, Web Analytics software, Support tool and other products. Octoboard has over 60 integrations built for you.

How to add a connection

Application connections are defined for individual clients or teams in Octoboard. Client or team members only see connections that have been added for them.

To see all connections defined per client go to LEFT MENU > CONNECTIONS.

Getting started with octoboard connections

Here you will see the list of available connected applications and their status.

To add a new Xero or other connection, click "CONNECT NEW APPLICATION" button visible on this screen. You will be presented with connection Wizard that will allow you to enter login details and complete the process.

Getting started with octoboard xero connected

Note: Sometimes application connections expire and you will need to re-connect. Re-connecting is easy. Simply click REFRESH icon on your expired connection.

Alternatively, you can click on "ADD METRIC" button in any dashboard or report and the same wizard will walk you through the process again.

How to add reports and dashboards

When you create your Octoboard account, you are presented with a blank dashboard and templates - for reports and dashboards (over 200 of them are available).

Getting started with octoboard launch

Note: We recommend verifying your email at this stage - this way your data will be updated automatically.

From the above screen you can proceed to adding connections and data to Octoboard. You can use the following simple methods to add data to reports and dashboards:

  • Adding data to dashboards: Using predefined dashboard templates
  • Adding data to dashboards: Using dashboard template wizard
  • Adding data to reports: Configuring sections in predefined report
  • Adding data to reports: Adding templates to existing reports

Following topics will explain each method in more details.

Remember, that all dashboards, reports and connections that you create are visible to users of the same client or user group in Octoboard. You can invite as many users as you like. They will only see information that you created for them.

To find out more about how user groups, clients and users work, read this tutorial in Octoboard Knowledge Base.

Adding data to dashboards: Using predefined dashboard templates

This is the easiest option to use. At the very top of the Octoboard interface you will see the list of available templates grouped into areas.

Go to LEFT MENU and check out DASHBOARDS section. This image shows Web Analytics group and a set of templates.

Getting started with octoboard verticals web

Feel free to browse each individual area (Web Analytics, Social, Media, PPC, Call Tracking, Email Marketing and so on).

Once you select a template all you will need to do to create a dashboard using it is to enter your credential (application connection). This image shows how Twitter connection initializing a new template-based dashboard.

Getting started with octoboard verticals connect

Once connected, you can always modify any created dashboard - add, remove and resize widgets. If you want to reset dashboard to initial configuration do the following:

1. Click RECONNECT button at the top of the screen

Getting started with octoboard reconnect button

2. Check RESET WIDGET LAYOUT checkbox in the connection window

Getting started with octoboard reset layout

Adding data to dashboards: Using dashboard template wizard

You can add a new template to an existing dashboard. To do that, click ADD DASHBOARD button at the bottom of the screen.

Getting started with octoboard add template

You will be be presented with a simple 3-step connection wizard.

Getting started with octoboard wizard template page

Follow the instructions to complete the wizard, which are:

STEP 1: Select Template

STEP 2: Connect to the App

STEP 3: Confirm addition of the new template

Getting started with octoboard wizard last step

Once you have clicked "SAVE AND CONTINUE" you will add a new template to your existing dashboard.

Note: you can use the same wizard to add individual widgets to existing dashboards. It is possible to combine widgets from different applications in the same dashboard (or report).

Adding data to reports: Configuring sections in predefined report

Octoboard will allow you build custom reports or create them quickly using our templates. Marketing agencies use reports to save time and send automated updates to their clients. Businesses send reports to internal teams to update them on the progress.

This tutorial covers in detail the process of creating a report by using configurable sections as well as setting up scheduled updates.

Tutorial: How to schedule automated reports

As always, you can modify any section of the report - add, remove, resize widgets and re-set them to default states. To re-set dashboards and reports sections click RECONNECT button at the top of the screen and check RESET WIDGET LAYOUT checkbox in the connection window:

Getting started with octoboard reset layout

Adding data to reports: Adding templates to existing reports

To add a template to an existing report follow these steps.

1. Click ADD SECTION button in your report

Getting started with octoboard add section

2. Select FROM TEMPLATE option and pick your report

Getting started with octoboard from template

Note: you can do the same and add data based on existing dashboard.

Useful tip: Cloning dashboards and reports

Created app logins, dashboard and reports are visible to individual clients within Octoboard. However, you can use CLONING to copy your best work (dashboards and reports) across to any number of clients. Cloning will save you a lot of time. In fact, we recommend that you do not create reports or dashboards from scratch but always use existing templates or improve your best dashboards and reports by cloning them.

The following tutorial explains how to use cloning:

Tutorial: How to clone dashboards and reports

Data storage

Octoboard does not modify application data. Read-only access will be requested. In case of Xero, Octoboard will only use analytics API to retrieve metrics for display in dashboard and reports. Detailed information (such s account data or contact information) is not requested or stored by Octoboard.

Octoboard data flow

Final words

You have completed our Getting Started tutorial. You have seen how to connect to applications, how to add data to dashboards, how to schedule reports and clone data across clients in Octoboard.

Below are a few more tutorials that you might find helpful.

Tutorial: Sharing data with clients and teams

Tutorial: Setting up multiple clients (teams) and inviting users

Tutorial: Creating client portals

These tutorials are part of The Octoboard Knowledge Base. Check it out when you get a chance. Enter any keyword in the search field and the Knowledge Base will show relevant tutorials and posts to help you with your questions. If you do not find what you are looking for - please contact us using Octoboard support line. To access our support line click LEFT MENU > SUPPORT when using Octoboard.