Skip to main content
Hazel Chat offers powerful integration capabilities to extend your workspace with automation, notifications, and third-party services.

​
Available Integrations

Bots

Create custom bots with the Bot SDK to automate tasks, respond to messages, and integrate with external services.

GitHub

Subscribe channels to GitHub repositories and receive real-time notifications for commits, PRs, issues, and more.

RSS Feeds

Subscribe channels to RSS feeds and automatically post new items as they’re published.

Webhooks

Create incoming webhooks for channels to receive notifications from external services.

​
Integration Use Cases

​
Automation & Workflows

  • CI/CD Notifications: Receive GitHub deployment and workflow run updates in dedicated channels
  • Issue Tracking: Create Linear issues directly from chat messages with the Linear bot
  • Content Aggregation: Automatically post new blog posts, release notes, or news articles via RSS
  • Custom Alerts: Send notifications from monitoring tools using channel webhooks

​
AI & Assistance

  • AI Agents: Build intelligent bots that respond to @mentions and slash commands
  • Context-Aware Helpers: Create bots that use conversation history to provide relevant assistance
  • Tool Integration: Connect AI models with Linear, Craft, and other third-party APIs

​
Team Collaboration

  • Code Reviews: Subscribe engineering channels to GitHub PR notifications
  • Release Announcements: Post changelogs automatically using RSS or webhooks
  • Status Updates: Build bots that share deployment status, metrics, or system health

​
Getting Started

1

Choose Your Integration

Select the integration type that best fits your use case:
  • Bots for custom logic and interactive features
  • GitHub for repository notifications
  • RSS for content aggregation
  • Webhooks for simple incoming notifications
2

Set Up Authentication

  • Bots: Create a bot and generate an API token from Settings → Bots
  • GitHub: Install the Hazel GitHub App for your organization
  • RSS & Webhooks: No authentication required (organization admin only)
3

Configure Integration

Follow the specific integration guide:
4

Test & Deploy

  • Test your integration in a development channel
  • Monitor logs and events to ensure proper operation
  • Deploy to production channels once validated

​
Integration Permissions

​
Bot Scopes

Bots request specific scopes during creation:
  • messages:read - Read messages in channels where the bot is installed
  • messages:write - Send messages to channels
  • channels:read - Read channel information
  • channels:write - Create threads and update channel metadata
  • users:read - Read user information
  • reactions:write - Add/remove reactions on messages
  • commands:register - Register slash commands

​
GitHub & RSS

  • Requires organization admin permissions to create subscriptions
  • Subscriptions are channel-specific
  • Events are posted as the integration bot user

​
Webhooks

  • Requires organization admin permissions to create webhooks
  • Each webhook gets a unique token and URL
  • Webhooks can be enabled/disabled without deleting

​
Next Steps

Build Your First Bot

Learn how to create a bot with the Hazel Bot SDK

GitHub Integration

Connect GitHub repositories to your channels

RSS Feeds

Subscribe to RSS feeds for automated content

Incoming Webhooks

Set up webhooks for external notifications

Build docs developers (and LLMs) love

Get started for freeTalk to us