Guide: Using Slack with Databox

HOW TO

How to connect Databox to Slack

Unlike other integrations, Databox needs to be connected within Slack, rather than Slack being added as a Data Source connection within Databox. 

1
 To connect a Databox Account to a Slack channel, navigate to https://databox.com/slack
2
 Click Add to Slack.
3
 In the Post to drop-down list, select the Channel that you want Databox to post to.
4
 Click Install.
5
 You'll now receive a message from the Databox bot in the Channel you selected above. Under Apps select Databox and click on the URL to verify your Account.
Pro Tip: If you receive a message saying "it seems you have connected a slack bot before..", follow these steps
6
 Click Allow to grant permission and complete the connection process. 

How to disconnect Databox from Slack

1
 To disconnect a Databox Account from a Slack channel, navigate to https://databox.slack.com/apps. From within Slack, you can get here by clicking on the gear icon and navigating to Add Apps > View App Directory. 
2
 Click  Manage.
3
 This will bring you to the Apps page. Type Databox in the Search bar to find the Databox connection.
4
 Click on the Databox connection to open the Authentication page.
5
 At the bottom of the page in the Remove Application section, click Remove App.

How to update the channel where Databox is connected

In the channel where Databox is currently connected, send /kick @databox. In the channel where you want to connect Databox, send /invite @databox. You will now receive a confirmation message in the new channel. 

How to use Slack for Client Accounts

    Only Agency Accounts have access to Client Accounts. Learn more about how to become a Databox Agency Partner here

You are currently only able to connect one Databox Account to each Slack workspace. Because of this, it is not currently possible to connect Slack bots for several Client Accounts to one Slack workspace. 

It is on the roadmap to enable this functionality. In the meantime, you can create a separate Slack workspace for each of your Clients. You can then connect each Client Slack workspace with the corresponding Client Account in Databox. 

Within Slack, you can switch between workspaces to view data for different Clients. Scorecards, weekly summaries, and Alerts can be sent to the corresponding Slack workspace. 

How to use Slack commands

Once you've connected Databox to Slack, you can use Slack commands in a public or private channel, or talk directly to the Databox bot. 

Pro Tip: Any Scorecards that you have scheduled to be sent via Slack will automatically be sent to the Databox bot chat. Scorecards can not be automatically sent to specific channels.

In public or private channels, add @ before any command for the returned data to be visible to everyone in the Slack channel. Add / before any command for the returned data to only be visible to you. 

Popular commands are outlined below. 

  • Send databox help to return a list of all available commands
  • Send databox metrics to return a list of all available Metrics that are used on Databoards in your Account.
  • Send databox metrics [Metric name][Date Range] to report on specific data for the requested Metric. 
Pro Tip: You can use the following optional shorthands for Date Range entries: 
24h (last 24 hours), 1d (today), -1d (yesterday), -1w (last week), 7d (last 7 days), WTD (week to date), 14d (last 14 days), 30d (last 30 days), -1m (last month), MTD (month to date), etc. 
  • Send databox weekly to return your latest weekly summary
  • Send databox alerts to return a list of the 5 most recently triggered Alerts from your Account
  • Send databox scorecard to return a list of all existing Scorecards

How to handle an error

HOW TO HANDLE AN ERROR

"There was an error connecting your Slack account. Reason: This user already has a different Slack integration"

If your Account is already connected in a different Slack workspace, follow the steps below to connect your Account in a new Slack workspace. 

1
Navigate to the Slack workspace where your Account is connected
2
 Write "logout" command
3
Reconnect your Slack Account in a new workspace

"There was an error connecting your Slack account. Reason: This token already has a Slack bot connected"

You may receive this error if you successfully connected Slack and clicked on a link to authenticate Databox.

If you have connected the intended Databox Account...

1
 Ignore this error
2
 Type a command (like "databox scorecard"). There should be no further errors returned. 
If you would like to change the Databox Account connected...
1
Navigate to the Slack workspace where your Account is connected
2
 Write "logout" command
3
Reconnect the intended Databox Account in a new workspace

"It seems you have connected a Slack bot before..."

You may receive this error if you connected Databox with Slack before.

If you have want to keep the current connection..

1
 Ignore this error
2
 Type a command (like "databox scorecard"). There should be no further errors returned. 
If you would like to change the Databox Account connected...
1
Navigate to the Slack workspace where your Account is connected
2
 Write "logout" command
3
Reconnect the intended Databox Account in a new workspace

How to join the Databox Partner Slack workspace

Agency Partners are invited to join our Databox Partner Slack workspace. Learn how to join here.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us