> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/integrations-and-plugins/integrations/slack-beta.md).

# Slack - Beta

{% hint style="success" %}
**Audience:** Admins, Developers, Solution Architects

**Purpose:** Explains what the Slack integration is, when to use it, and how it works within <code class="expression">space.vars.Kizen\_company\_name</code>
{% endhint %}

## Overview

Send messages to your Slack® workspace channels directly from an <code class="expression">space.vars.automation</code>, and add mentions to workspace members from their email addresses.

{% hint style="info" %}
**Note:** The Slack integration is in Beta. It was built by <code class="expression">space.vars.Kizen\_company\_name</code> using the Slack public API. It is not created by, affiliated with, or supported by Slack Technologies, LLC.
{% endhint %}

### What Is the Slack Integration?

The Slack integration adds three action steps to the <code class="expression">space.vars.automation</code> builder in <code class="expression">space.vars.Kizen\_company\_name</code>:

* **Get Username:** Returns a person's Slack user name from their email address
* **Send Slack Message:** Sends a plain-text Slack message to a channel on your workspace
* **Send Slack Block Message:** Sends a formatted or interactive Slack message to a channel on your workspace

### When to Use the Slack Integration

Use the Slack integration when you want to send fully automated messages to your organization's Slack channels at any stage of a larger process, useful for status updates or to maximize the time for responses, comments, or approvals.

#### Common Use Cases

Here are some common use cases of the Slack integration:

* Surfacing critical updates instantly to a shared workspace so that the first available team member can triage the issue
* Automatically assigning and routing change requests to specific members of the team
* Coordinating work among remote employees

***

## How the Slack Integration Works

Before you configure the Slack integration, it's important to understand how it functions at a conceptual level.

### Connection Model

The integration connects to the Slack API through OAuth. A <code class="expression">space.vars.Kizen\_company\_name</code> user signs into their Slack account and authorizes through the integration's configuration settings.

See [Set Up Slack in Kizen](/docs/integrations-and-plugins/integrations/slack-beta/set-up-slack-in-kizen.md) for details.

{% hint style="info" %}
**Note:** If your organization has multiple workspaces, the integration can access all of them. In this case, when you post a message to a channel with an <code class="expression">space.vars.automation</code>, always identify the channel by its ID. Different workspaces might have channels with the same name.

For more information, see [Use Slack in an Agentic Workflow](/docs/integrations-and-plugins/integrations/slack-beta/use-slack-in-an-agentic-workflow.md).
{% endhint %}

### Authentication

The Slack platform's access tokens refresh automatically, but if somehow you lose your connection, you can re-authorize from the configuration settings. You can also revoke access to the Slack API at any time.

For more information, see [Set Up Slack in Kizen](/docs/integrations-and-plugins/integrations/slack-beta/set-up-slack-in-kizen.md).

### Message Posting

Your messages are posted by the <code class="expression">space.vars.Kizen\_company\_name</code> bot. The bot has access to every public channel on your workspace, but it can't post to a private channel until you invite it.

To invite the Kizen bot to a private channel, run the following command in the channel: `/invite @Kizen`.

### Rate Limits

The Slack API enforces different rate limits depending on the request type:

* The API imposes a rate limit of about 1 message per second per channel, with bursts allowed.
* For user name lookups, the API imposes a rate limit of about 20 requests per minute.&#x20;

If a Slack step in your <code class="expression">space.vars.automation</code> exceeds a rate limit, the <code class="expression">space.vars.automation</code> pauses and retries the step. If it fails again, the entire <code class="expression">space.vars.automation</code> fails at that step.

***

## Available Slack Actions and Topics

For step-by-step instructions on using the Slack integration, see the following topics:

* [Set Up Slack in Kizen](/docs/integrations-and-plugins/integrations/slack-beta/set-up-slack-in-kizen.md)
* [Use Slack in an Agentic Workflow](/docs/integrations-and-plugins/integrations/slack-beta/use-slack-in-an-agentic-workflow.md)
* [Troubleshoot Slack](/docs/integrations-and-plugins/integrations/slack-beta/troubleshoot-slack.md)

***

## What's Next

Ready to connect? Continue to [Set Up Slack in Kizen](/docs/integrations-and-plugins/integrations/slack-beta/set-up-slack-in-kizen.md) to authorize the integration for your Slack workspace.&#x20;

<details>

<summary><strong>Related Topics</strong></summary>

* [Set Up Slack in Kizen](/docs/integrations-and-plugins/integrations/slack-beta/set-up-slack-in-kizen.md)
* [Use Slack in an Agentic Workflow](/docs/integrations-and-plugins/integrations/slack-beta/use-slack-in-an-agentic-workflow.md)
* [Troubleshoot Slack](/docs/integrations-and-plugins/integrations/slack-beta/troubleshoot-slack.md)

</details>

***

*Slack is a registered trademark and service mark of Slack Technologies, Inc. Kizen's Slack integration is not created by, affiliated with, or supported by Slack Technologies, LLC.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.kizen.com/docs/integrations-and-plugins/integrations/slack-beta.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.