Slack

Connect the Credible bot (@CredibleData) to Slack, bind a channel to a workspace, and ask questions in channels and direct messages

The Credible bot, @CredibleData, answers data questions in Slack. It runs the same agent as Chat with Your Data, against the packages of the workspace a channel is bound to, and saves each conversation as a chat in that workspace. An organization admin connects Slack, and then anyone with a Credible account can ask the bot.

Prerequisites

  • Connecting Slack takes an organization admin in Credible, and permission to install apps in your Slack workspace.
  • Each person who asks the bot a question needs a Credible account in the organization, and access to the workspace the channel is bound to.

Set Up Slack

1. Connect Slack (organization admin)

  1. In the Credible app, open the settings gear and choose Settings.
  2. Under Integrations, click Connect Slack.
  3. Approve the app in Slack.

The Slack card then shows the workspace as connected. Disconnect on the same card removes it.

2. Add the bot to a channel

Invite @CredibleData to the channel where people will ask questions.

3. Bind the channel to a workspace

Each channel answers from one Credible workspace. In the channel, run:

  1. /credible_list to list the workspaces you can use.
  2. /credible_set_workspace <workspace_name> to bind the channel to one.

If someone mentions the bot in a channel with no workspace, the bot replies with the list and the command to set one.

The first time you mention the bot, it sends you a link to connect your Slack identity to your Credible account. Each person links their own account. After you link, the bot answers the message that prompted it.

Ask a Question

Mention the bot in a bound channel:

@CredibleData What were our top 10 products by revenue last quarter?
  • The bot replies in a thread. Inside that thread, reply without mentioning it again.
  • If you mention the bot partway through an existing thread, it reads the earlier messages in that thread as context.
  • After its first answer in a new thread, the bot posts a link to the conversation in the Credible app, where you can see full results and continue.
  • The conversation is saved as a chat in the channel's workspace, visible to that workspace's members.

Direct messages

Send @CredibleData a direct message to ask privately. Direct-message conversations are saved in your personal workspace and answer from every package you can read.

Who Sees What

Each question runs under the name of the person who asked it. In a channel bound to a shared workspace, it runs with the workspace group's access, not the person's own, so everyone who asks in that channel can reach the same data. A model that reads a person's own access values, such as a custom secure given, is refused there. The answer is then posted to Slack, where anyone in the channel can read it, including people without a Credible account. Your Slack workspace's access and retention settings apply to those messages. Bind a channel only to a workspace whose data everyone in the channel may see.

Troubleshooting

ProblemCauseFix
The bot doesn't answer a thread replyIt only answers threads where it was mentionedMention it in the thread
This channel doesn't have a workspace configured yet.The channel isn't bound to a workspaceRun /credible_set_workspace <workspace_name> in the channel
I'm still working on your earlier message in this thread.The bot is still answering the previous messageWait for the previous answer, then send your message again

Next Steps

On this page