> ## Documentation Index > Fetch the complete documentation index at: https://docs.vizkraft.com/llms.txt > Use this file to discover all available pages before exploring further. # Use Vizkraft in Slack > Ask questions about your data directly from Slack, understand the linking flow, and learn how replies, charts, and reactions work. 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: | Layer | What it means | | ---------------------- | ----------------------------------------------------------------------------------------------------------------- | | Workspace installation | The Vizkraft Slack app is installed for your organization's Slack workspace. | | User account linking | Your 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: ```text theme={null} /vizkraft ``` Example: ```text theme={null} /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. | Reaction | What 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.