Skip to main content
Vizkraft lets you chat with your data directly from Slack once your workspace and account are connected.

​
What Slack support includes

With Slack enabled, users can:
  • Mention @Vizkraft in a channel.
  • Use the /vizkraft slash command.
  • Continue the conversation by replying in the same Slack thread.
  • Receive text answers, chart images, insights, and follow-up suggestions.
  • Open the full conversation in the Vizkraft web app when they want a deeper workflow.

​
How Slack setup works

There are two layers to Slack setup:
LayerWhat it means
Workspace installationThe Vizkraft Slack app is installed for your organization’s Slack workspace.
User account linkingYour Slack identity is linked to your Vizkraft account so Vizkraft knows which data access and connectors to use.

​
Connect Slack from the UI

Users start the flow from Preferences.
  1. Open Preferences.
  2. Find the Slack card.
  3. Select Connect Slack.
  4. Complete the Slack authorization flow.
  5. Return to Vizkraft.
When the Slack OAuth callback succeeds:
  • the Slack workspace installation is stored for your organization
  • the user who completed the install is automatically linked to their Vizkraft account
  • the app returns to Preferences

​
What you can manage from Preferences

After your account is linked, the Slack card can show:
  • your connected workspace
  • your linked Slack account
  • a default connector for Slack
  • a button to disconnect your own account
If you are an admin, the same area can also show who installed the workspace app and when, plus an option to remove the Slack app from the workspace for the whole organization.

​
Default connector behavior

Slack uses one connector for a user at a time.
  • If you only have one connector, Vizkraft uses it automatically.
  • If you have multiple connectors, you should set a default connector in Preferences.
  • If a default is set, Vizkraft uses that connector when you ask a Slack question.
  • If no default is set and multiple connectors exist, Vizkraft falls back to the first available connector.

​
Ask a question with @Vizkraft

You can tag @Vizkraft in any channel where the app is available. Example:
  • @Vizkraft what were the top 10 customers by revenue last month?
What happens next:
  1. Vizkraft detects the mention.
  2. The app checks whether your Slack user is linked to a Vizkraft account.
  3. If you are linked, Vizkraft processes the question and replies in a thread.
  4. If charts are generated, chart images are uploaded into the thread before the main text response.
If you mention @Vizkraft without adding a question, Vizkraft replies in the thread with a prompt asking what you want to know and includes an example question.

​
Ask a question with /vizkraft

You can also use: 
/vizkraft <your question>
Example: 
/vizkraft Show me daily signups for the past 30 days
If you run /vizkraft with no question, or use /vizkraft help, Vizkraft sends an ephemeral help message with examples and usage guidance. When you do ask a question with /vizkraft:
  • Vizkraft posts a visible question message in the channel
  • the answer appears in a thread under that message
  • the same follow-up and chart behavior applies there too

​
Follow-up questions in threads

Slack threads are how Vizkraft keeps context. Once a Vizkraft question starts a thread:
  • you can reply in that same thread to continue the conversation
  • you do not need to tag @Vizkraft again for follow-up replies in that thread
  • Vizkraft maps the Slack thread to a Vizkraft chat session so previous context is preserved
If you reply in a random thread that is not already connected to a Vizkraft chat, Vizkraft does not treat it as a continuation. If a previous Slack request in the same thread is still running, Vizkraft shows an ephemeral message asking you to wait for the earlier question to finish.

​
What happens if your Slack account is not linked

If you mention @Vizkraft or use /vizkraft before linking your Slack account:
  • Vizkraft does not answer the question yet
  • Slack shows an ephemeral message only to you
  • that ephemeral includes a Connect account button
  • it also includes an I've linked my account button so you can confirm after finishing setup
If you click I've linked my account before linking successfully, Vizkraft updates the ephemeral with a reminder to finish setup first. If linking has already completed, Vizkraft clears the old prompt and shows a confirmation that your Slack account is now linked.

​
Slack reactions and status emojis

Vizkraft uses reactions to show progress on message-based Slack questions.
ReactionWhat it means
:eyes:Vizkraft received the question.
:hourglass_flowing_sand:Vizkraft is processing the request.
:white_check_mark:The response finished successfully.
:speech_balloon:Vizkraft replied and the conversation is ready for follow-up questions.
:x:The request failed.
:link:The user is not linked and needs to connect their Slack account.

​
What the Slack response contains

Depending on the result, Slack can show:
  • the main answer text
  • key insights
  • up to a few suggested follow-up questions
  • chart images uploaded into the thread
  • a View in Vizkraft link back to the app
Long answers can be shortened in Slack with a link back to the full chat in Vizkraft.

​
App Home in Slack

Vizkraft also updates its Slack App Home. If your account is linked, App Home can show:
  • that your account is connected
  • examples of questions to ask
  • a quick explanation of mentions, slash commands, and follow-ups
If your account is not linked, App Home shows a connect prompt and a button that opens the Vizkraft app so you can finish setup.

​
When Vizkraft cannot answer

Slack requests can fail for customer-facing reasons such as:
  • your Slack account is not linked
  • no connector has been configured in Vizkraft
  • the connector is temporarily unavailable
  • your organization is inactive
  • the request fails while processing
In those cases, Vizkraft responds with an error message in Slack rather than silently failing.

​
FAQs

​
Do I need to tag @Vizkraft for every follow-up?

No. Once a Vizkraft conversation has started in a Slack thread, you can keep replying in that thread without tagging the app again.

​
What if I tag @Vizkraft before linking my account?

You get an ephemeral prompt with buttons to connect your account and confirm after linking. Other users in the channel do not see that prompt.

​
What if I use /vizkraft with no question?

Vizkraft sends an ephemeral help message with usage instructions and example prompts.

​
Where do answers appear in Slack?

For mentions and slash commands, Vizkraft replies in a thread. Slash commands also create a visible top-level question message in the channel first.

​
What if I mention @Vizkraft without a question?

Vizkraft replies in the thread with a short prompt asking what you want to know and gives an example of the kind of data question you can ask.

​
What if I ask another question before the current one finishes?

Vizkraft shows an ephemeral wait message in that thread so you know the previous request is still processing.

​
Does Slack return charts too?

Yes. When charts are generated, Vizkraft uploads chart images into the thread before posting the text response.

​
What connector does Slack use?

Slack uses your default connector if you set one in Preferences. If you have only one connector, that one is used automatically.

​
Can I disconnect Slack later?

Yes. Users can disconnect their own linked account from Preferences, and admins can remove the Slack app from the workspace for the organization.

​
Where should I go for chart editing or dashboards?

Slack is great for asking and following up quickly. For chart editing, saved charts, dashboards, filters, and exports, open the linked conversation in the Vizkraft web app.