Skip to main content
waffle.svg
Domo Knowledge Base

CallRail Connector

Version 8

 

Intro

CallRail provides call analytics services to help businesses learn what makes their phones ring. Use Domo's CallRail Connector to retrieve data on calls, companies, sources, call & SMS alerts, and so on. To learn more about the CallRail API, visit their page (http://apidocs.callrail.com/).

You connect to your CallRail account in the Data Center. This topic discusses the fields and menus that are specific to the CallRail connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

Prerequisites

To connect to your CallRail account and create a DataSet, you must have a CallRail API Key. To obtain an API key, do the following:

  1. Log into your CallRail account.

  2. In the CallRail dashboard, select My Account > Account in the top right corner.

  3. Select API Access.

  4. Click Add API Key in the top right.

Your CallRail API Key appears in the table. 

Connecting to Your CallRail Account

This section enumerates the options in the  Credentials  and  Details  panes in the CallRail Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

Credentials Pane

This pane contains fields for entering credentials to connect to your CallRail account. The following table describes what is needed for each field:  

Field

Description

API Key Enter your CallRail API Key. For information about obtaining an API Key, see "Prerequisites," above.

Once you have entered valid CallRail credentials, you can use the same account any time you go to create a new CallRail DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

Details Pane

This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.

Menu

Description

Report

Select the CallRail report you want to run. The following reports are available:

Calls

Returns a list of calls in your account.

Companies

Returns a list of the companies in your account.

All Conversations

Returns all the two most recent messages for all conversations.

Form Submissions

Returns all form submissions associated with the target account.

Notifications

Returns notifications for the target account.

Outbound Caller IDs

Returns all outbound caller IDs within the target company.

Summarizing Call Data

Returns summarized call data for an agency or company.

Summarizing Call Data by Time Series

Returns aggregate call data for an account or company, grouped by date.

Summary Email Subscriptions

Returns summary emails within the target account or company.

Tags

Returns a list of tags for the specified company.

Trackers

Returns all trackers associated with the target account.

Users

Returns a list of all users in your account.

Account ID

Select the account you want to retrieve data for.

Company ID

Select the company you want to retrieve data for.

User ID

Select the user you want to retrieve data for.

Group By

Select the category you want to group data in your report by (by campaign, by company, etc.).

Fields 

Select a field to aggregate data by in your "Summarizing Call Data by Time Series" report.

Duration 

Select whether you want to pull data for a specific date or a date range. 

Report Date 

Select whether the report data is for a specific date or for a relative number of days back from today. 

Select Specific Date 

Select the date for the report. 

Days Back

Enter the number of past days that should appear in the report.  

Start Date

Specify whether the first date in your date range is a specific or relative date. You select the last date in your range in End Date

End Date

Specify whether the second date in your date range is a specific or relative date. You select the first date in your range in Start Date.  

Select Specific Start Date

Select the first date in your date range. 

Select Specific End Date

Select the second date in your date range. 

Days Back to Start From

Enter the number of the farthest day back that should be represented in the report. Combine with Days Back to End At to create a range of represented days.

For example, if you entered 10 for Days Back to Start From and 5 for Days Back to End At, the report would contain data for 10 days ago up until 5 days ago.

Days Back to End At

Enter the number of the most recent day back that should be represented in the report. Combine with Days Back to Start From to create a range of represented days.

For example, if you entered 10 for Days Back to Start From and 5 for Days Back to End At, the report would contain data for 10 days ago up until 5 days ago.

Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.

FAQs

What version of the CallRail API does the connector use?

This connector uses version 2 of the CallRail API (https://api.callrail.com/v2).

Which endpoints does each report call in this connector?
Report  Endpoint URL
Calls /a/{account_id}/calls.json
Companies /a/{account_id}/companies.json
All Conversations /a/{account_id}/text-messages.json
Form Submissions /a/{account_id}/form_submissions.json
Notifications /a/{account_id}/notifications.json
Outbound Caller IDs /a/{account_id}/caller_ids.json
Summarizing Call Data /a/{account_id}/calls/summary.json
Summarizing Call Data by Time Series /a/{account_id}/calls/timeseries.json
Summary Email Subscriptions /a/{account_id}/summary_emails
Tags /a/{account_id}/tags.json
Trackers /a/{account_id}/trackers.json
Users /a/{account_id}/users.json
How often can the data be updated?

As often as needed.

Are there any API limits I should be aware of?

No.