#  Slack Integration

# HeyGen for Slack

Transform your Slack messages into professional AI-generated videos, instantly.

## What is HeyGen for Slack?

The HeyGen Slack app brings the power of AI video generation directly into your workspace. Create professional videos from text prompts without leaving Slack — perfect for team updates, tutorials, announcements, and more.

## Features

* **Instant video creation** - @mention HeyGen with your video idea and get a video in minutes
* **Emoji reactions** - React to any message with 🎥 to turn it into a video
* **Message curation** - Use `/heygen-curate` to find and compile top messages into videos
* **Personal accounts** - Connect your own HeyGen account to use your credits and avatars
* **Rich previews** - HeyGen video links automatically unfurl with thumbnails and metadata

## Installation

### Prerequisites

* **Slack workspace admin permissions** to install apps
* **A HeyGen account** with available video credits (<Anchor label="sign up here" target="_blank" href="https://app.heygen.com">sign up here</Anchor>)
* Your HeyGen **username** and **space ID** ready

### Step 1: Install the app

1. Go to the <Anchor label="HeyGen Slack App" target="_blank" href="https://slack.com/oauth/v2/authorize?client_id=2341957757140.9185742217618&scope=app_mentions:read,channels:history,channels:read,chat:write,commands,files:read,files:write,groups:history,groups:read,im:history,im:read,im:write,links:read,links:write,mpim:history,mpim:read,reactions:read,users:read&user_scope=openid,profile">HeyGen Slack App</Anchor> in the Slack App Directory
2. Click **Add to Slack**
3. Select your workspace and click **Allow**

### Step 2: Connect your HeyGen account

After installation, you'll be redirected to connect your HeyGen account:

* **If you're already logged into HeyGen**: Installation completes automatically. You're done!
* **If you're not logged in**: You'll be redirected to HeyGen to log in, then complete the setup by selecting which HeyGen space to use

That's it! The HeyGen bot is now available in your workspace.

## How to use

### Method 1: @mention the bot

Simply @mention HeyGen with your video idea:

```
@HeyGen Create a welcome video saying "Welcome to our team! We're excited to have you here."
```

The bot will:

1. Acknowledge your request
2. Generate the video using your HeyGen account
3. Post the finished video in the thread

### Method 2: React with 🎥 emoji

Convert any message into a video by reacting with the camera emoji:

1. Find a message you want to turn into a video
2. Click **Add reaction** (or press `R`)
3. Choose the 🎥 `:movie_camera:` emoji

The bot will use the message text as the video script.

**Tip:** You can also use a custom `:heygen-video:` emoji if your workspace has one.

**Note:** There's a 5-minute cooldown per message to prevent duplicate videos.

### Method 3: Curate channel messages

Use the `/heygen-curate` slash command to find and compile top messages:

```
/heygen-curate [#channel] [--notify] [--days N]
```

**Examples:**

```
/heygen-curate
/heygen-curate #marketing --days 7 --notify
```

This will:

* Analyze recent messages in the channel (default: last 7 days)
* Score messages based on reactions, replies, and engagement
* Present the top 3 messages
* Optionally notify the thread with `--notify`

## Personal account linking

By default, videos use the workspace's HeyGen account. Team members can link their personal HeyGen accounts to use their own credits and avatars.

### Why link your account?

* Videos you request will use and be saved on **your HeyGen account**
* You'll use **your video credits** and **your avatars**
* Other team members continue using the workspace default

### How to link your account

1. **Visit your HeyGen account settings** at <Anchor label="app.heygen.com" target="_blank" href="https://app.heygen.com/settings?from=&nav=General">app.heygen.com</Anchor>
2. Navigate to **Connections** → **Slack**
3. Click **Link your Slack account**
4. Sign in to Slack and authorize the connection

Once linked, all videos you create will use your personal HeyGen account.

### Check your link status

1. On the <Anchor label="settings" target="_blank" href="https://app.heygen.com/settings?from=&nav=Connections">settings</Anchor> menu, Make sure you are on **Connections**
2. Check to see if the button is grayed out or says *unlink* on the Slack card

If the button is grayed out or says *unlink*, your heygen account and slack accounts are connected.

### Unlink your account

To stop using your personal account and switch back to the workspace default:

1. Go to your **<Anchor label="HeyGen account settings" target="_blank" href="https://app.heygen.com/settings?from=&nav=General">HeyGen account settings</Anchor>**
2. **Connections** → **Slack**
3. Click **Unlink**

## Rate limits

To ensure fair usage, the following limits apply:

| Action                  | Limit                                       |
| ----------------------- | ------------------------------------------- |
| Video creation          | 50 per minute, 500 per hour (per workspace) |
| /heygen-curate command  | 30 per minute, 300 per hour (per workspace) |
| Emoji reaction cooldown | 1 video per message every 5 minutes         |

If you hit a rate limit, wait a few minutes and try again. You'll see a message like:

<Callout icon="⏳" theme="default">
  ### Rate limit reached. Please wait a moment and try again.
</Callout>

## Troubleshooting

### "Workspace not installed" error

**Problem:** The bot responds with "Workspace not installed. Please reinstall the HeyGen app."

**Solution:**

* The app may have been uninstalled or credentials revoked
* Reinstall the app following the [Installation](https://docs.heygen.com/docs/slack#installation) steps
* Make sure a workspace admin completes the HeyGen account connection

### Bot doesn't respond to @mentions

**Problem:** You @mentioned the bot but nothing happened.

**Check:**

* The bot must be invited to the channel (`/invite @HeyGen`)
* You have available HeyGen video credits
* You're not hitting rate limits (see [Rate limits](https://docs.heygen.com/docs/slack#rate-limits))
* Check the thread for error messages

### Video generation failed

**Problem:** The bot acknowledged your request but the video never arrived.

**Possible causes:**

* **Insufficient credits** - Check your HeyGen account balance
* **Invalid script** - Make sure your prompt is clear and complete
* **API errors** - Try again in a few minutes

**Get help:** Send a direct message to the bot for support information.

### Emoji reaction doesn't work

**Problem:** You reacted with 🎥 but no video was created.

**Check:**

* You're using the correct emoji: 🎥 `:movie_camera:` or `:heygen-video:`
* The message hasn't had a video generated in the last 5 minutes (cooldown)
* The message has enough text to create a video (minimum \~10 words recommended)

### "Invalid HeyGen credentials" error

**Problem:** Videos aren't generating and you see credential errors.

**Solution:**

* Your HeyGen username or space ID may be incorrect
* A workspace admin should:
  1. Go to your Slack workspace settings
  2. **Apps** → **HeyGen** → **Configuration**
  3. Update the HeyGen credentials
  4. Save changes

## FAQ

### How much does it cost?

The HeyGen Slack app is free to install. Video generation uses HeyGen credits from your account:

* **Workspace default**: Uses the account configured during installation
* **Personal linking**: Uses your own HeyGen account and credits

See <Anchor label="HeyGen pricing" target="_blank" href="https://heygen.com/pricing">HeyGen pricing</Anchor> for credit costs.

### Can I choose which avatar to use?

By default, videos use your HeyGen account's default avatar. To customize:

* Link your personal HeyGen account (see <Anchor label="Personal account linking" target="_blank" href="https://app.heygen.com/settings?from=&nav=Connections">Personal account linking</Anchor>)
* By default, Video Agent will auto-select most recently used avatar from your workspace
* The bot will automatically use that avatar for your videos

### Where are videos stored?

Videos are:

1. Created in your HeyGen workspace (visible in your <Anchor label="HeyGen dashboard" target="_blank" href="https://app.heygen.com">HeyGen dashboard</Anchor>)
2. Uploaded directly to Slack (stored in your Slack workspace files)
3. Accessible via the Slack message thread

### Can I use this in private channels?

Yes! Invite the HeyGen bot to any channel:

```
/invite @HeyGen
```

The bot works in:

* Public channels
* Private channels
* Direct messages
* Group messages

### Is my data secure?

* **Message content** is sent to HeyGen's API only when you explicitly request a video
* **Credentials** are encrypted and stored securely
* The bot only reads messages where it's @mentioned or reacted to
* See [HeyGen's security policies](https://heygen.com/security) for details

### How do I uninstall?

To remove the HeyGen app:

1. Go to your **Slack workspace settings**
2. **Apps** → **HeyGen**
3. Click **Remove App**
4. Confirm removal

Your workspace data will be marked as deactivated but not deleted (for potential reinstallation).

## Tips & best practices

### Writing great video prompts

**Do:**

* Be specific and clear: *"Create a welcome video introducing our new design system update"*
* Include context: *"Make a tutorial video explaining how to use the new login flow"*
* Keep it concise: Aim for 30-90 seconds of content

**Don't:**

* Be too vague: ~~"Make a video"~~
* Use very long scripts: Messages over \~500 words may be truncated
* Include formatting: The bot uses plain text, not markdown

### Using /heygen-curate effectively

The curate command works best with:

* **Active channels** with regular discussion
* **Time range**: Last 24-48 hours typically has the best content
* **Engagement metrics**: Reactions and replies indicate valuable messages

**Pro tip:** Use `--notify` in channels where you want to create visibility around the curation process.

### Managing workspace credits

To avoid surprise credit usage:

* Set up **usage alerts** in your HeyGen account
* Encourage personal account linking for team members who create many videos
* Monitor usage in your [HeyGen analytics dashboard](https://app.heygen.com/analytics)

## Support

Need help?

* **Documentation**: [docs.heygen.com/slack](https://docs.heygen.com/slack)
* **Email**: [support@heygen.com](mailto:support@heygen.com)
* **Community**: Join our community for tips and discussions

***

**Ready to get started?** Install HeyGen for Slack now and start creating videos instantly.