---
title: "Slack"
description: "安装 Slack，让流程可以从 Pyn Bot、自定义机器人或同事自己的账户发送私信、发布到频道，以及邀请人员加入频道。"
sidebar:
  label: 概览
  order: 0
area: integrations
feature: slack
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-02"
audience: admin
related:
  - integrations/slack/add-a-custom-bot
  - settings/senders/add-a-slack-sender
  - settings/senders/create-an-auth-link
  - integrations/sync-and-matching
  - flows/steps/format-a-message
intercom:
  - id: "14983837"
    title: Installing the Slack Integration (Pyn 2)
    url: https://intercom.help/pyn/en/articles/14983837-installing-the-slack-integration-pyn-2
    note: replaces
  - id: "6024093"
    title: What read/write access does Pyn use for the Slack integration?
    url: https://intercom.help/pyn/en/articles/6024093-what-read-write-access-does-pyn-use-for-the-slack-integration
    note: draws on
  - id: "6767588"
    title: Using Pyn with Slack
    url: https://intercom.help/pyn/en/articles/6767588-using-pyn-with-slack
    note: draws on
  - id: "6002189"
    title: Connect to Slack (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6002189-connect-to-slack-pyn-1
    note: "Pyn 1 article, kept for reference"
  - id: "16755898"
    title: Set up a Custom Slack Sender/Slack Bot (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755898-set-up-a-custom-slack-sender-slack-bot-pyn-2
  - id: "9585758"
    title: Send Slack messages from a service account (Pyn 1)
    url: https://intercom.help/pyn/en/articles/9585758-send-slack-messages-from-a-service-account-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/slack/index.mdx
  sourceSha: 2c82b510fa4a5211ba2ae54b144c206cd45fe2ed
---

Slack 集成把一个 Slack 工作区连接到 Pyn。安装后，步骤可以发送私信、发布到频道或邀请某人加入频道，员工可以不离开 Slack 就回答投票和表单，Slack 成员按邮箱匹配到员工。消息来自 **Pyn Bot**、来自带有你自己名称和图标的[自定义机器人](https://support.pyn.ai/zh-cn/integrations/slack/add-a-custom-bot/)，或来自[把自己添加为 Slack 发件人](https://support.pyn.ai/zh-cn/settings/senders/add-a-slack-sender/)的同事。

## 开始之前

- 你是 Pyn 中的管理员或所有者。
- 你可以在该 Slack 工作区中授权应用，或者你的 Slack 管理员批准 Slack 向你显示的请求。
- 在浏览器中登录该 Slack 工作区。Slack 在其授权页面的右上角显示工作区。
- Pyn 请求的机器人权限范围：`app_mentions:read`、`channels:read`、`channels:write.invites`、`chat:write`、`groups:read`、`groups:write.invites`、`im:history`、`im:read`、`im:write`、`team:read`、`users:read` 和 `users:read.email`。机器人无法读取频道消息，也无法自行加入频道；它只在被邀请的地方发帖。

![The Slack tile under Available; selecting it starts the Slack sign-in.](https://support.pyn.ai/media/integrations/slack/integrations-slack-available.png)

## 连接

1. 在 Pyn 中，打开左侧导航中的 **Settings**，然后打开 **Integrations** 下的 **Available**。

2. 选择 **Slack** 磁贴。Slack 打开。

3. 检查右上角显示的工作区是你想要的那个，查看权限并选择 **Allow**。

4. Slack 把你带回 Pyn。Slack 磁贴在 **Installed** 下显示 **Active**。

5. 打开磁贴。**Details** 显示 **Team Id**、**Requires Reauthentication**（false）和刷新时间。可选：在 Slack 中把 Pyn Bot 邀请到你计划发帖的频道。

如果某个工作区有一个标记为 **Ready to Connect** 的 Slack 磁贴，打开它并选择 **Connect Now**："Connecting to Slack allows you to send timely, automated messages to your employees." Pyn 可以为每个 Slack 工作区保留一个集成；**...** 菜单中的 **Connect another workspace** 添加第二个。

## 同步的内容

- **成员**：每个 Slack 用户的姓名、用户名、邮箱、头像和时区，大约每小时刷新一次。成员按 Slack id 或邮箱匹配到员工；见[同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)。成员匹配成功后，员工的资料会立即使用其 Slack 头像。
- **频道**：在启用了频道刷新的工作区中，**Channels** 标签页列出 **Public Channels**，并在 **Private Channels** 下列出 Pyn Bot 是其成员的频道，每个显示为 `#name - n members (Slack Identifier: id)`；频道成员每天更新。频道出现在这里后，就会出现在步骤的 **To** 列表中。
- **发件人**：Pyn Bot 随集成一起创建；自定义机器人和个人发件人之后添加。
- **投递**：每条消息、帖子和频道邀请都是[活动记录](https://support.pyn.ai/zh-cn/activity/)中的一条投递。

## 测试

打开 Slack 磁贴，打开 **...** 菜单并选择 **Test Connection**。"Test successfully sent. Check your Slack account for the test message." 表示 Pyn Bot 给你发送了一条私信。"Slack appears to be configured, but we could not find you as a Slack Member to send the test message." 表示你的 Pyn 邮箱在该工作区中没有匹配到任何成员。"There is a misconfiguration preventing the test. Please contact support." 表示集成本身失败了。

## 重新连接或断开连接

- Slack 撤销令牌时，面板显示 "This integration is not operational as it requires re-authentication. This can happen if credentials are revoked." 并带有 **Reconnect**，它会返回同一个 Slack 工作区。磁贴也会出现在 **Needs Attention 🚨** 下，并且有一条通知带有同一个按钮。
- **Deactivate** 停止所有 Slack 发件人和投递；**Activate** 恢复。

## 故障排除

| 你看到的 | 含义 |
| --- | --- |
| "We could not start the Slack connection. Please contact support." | Pyn 无法开始 Slack 登录。重试，然后联系支持。 |
| Slack 显示管理员审批页面 | 你的工作区要求应用经管理员批准。提交请求，让 Slack 管理员批准，然后再次连接。 |
| 步骤的 **To** 列表中缺少某个频道 | 机器人不在该私有频道中，或该频道是在上次刷新之后创建的。邀请机器人并等待几分钟；发件人没有频道时，步骤显示 "No results"。 |
| 频道发帖失败 | 发件人不是该频道的成员。邀请机器人或自定义机器人，或你自己加入该频道。 |
| 某人没有匹配 | 其 Slack 邮箱与你 HRIS 中的工作邮箱不同。更正其中一个，或在员工记录上使用 **Disconnect** 清除错误的匹配。 |
| 你连接了错误的工作区 | 选择 **Deactivate** 停用它，用 **...** 菜单中的 **Connect another workspace** 添加正确的那个，并请支持移除错误的那个。 |

## 相关

- [添加自定义机器人](https://support.pyn.ai/zh-cn/integrations/slack/add-a-custom-bot/)，用你自己的机器人名称和图标发送。
- [添加 Slack 发件人](https://support.pyn.ai/zh-cn/settings/senders/add-a-slack-sender/)，以你自己的身份发送。
- [创建认证链接](https://support.pyn.ai/zh-cn/settings/senders/create-an-auth-link/)，供没有 Pyn 登录账号的发件人使用。
- [同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)，了解成员如何成为员工。
- [设置消息格式](https://support.pyn.ai/zh-cn/flows/steps/format-a-message/#%E6%8F%90%E5%8F%8A%E4%BA%BA%E5%91%98%E5%92%8C%E9%A2%91%E9%81%93)，提及该员工、按 Slack 用户名提及同事或提及整个频道。
