Slack

Send Nebutra notifications to Slack — new members, quota warnings, billing events.

Overview

The Slack integration sends real-time notifications to a Slack channel of your choice when important events occur in your Nebutra organization.

Step 1: Create a Slack App

Go to api.slack.com/apps and click Create New App

Choose From scratch

Name it "Nebutra" and select your workspace

Under OAuth & Permissions, add these bot scopes:

chat:write
chat:write.public
channels:read

Install the app to your workspace and copy the Bot User OAuth Token

Step 2: Configure the integration

In the Nebutra dashboard: Settings → Integrations → Slack → Connect

Or set environment variables:

SLACK_BOT_TOKEN=xoxb-xxxxxxxxxxxx
SLACK_CHANNEL_ID=C0XXXXXXXXXX  # Channel to send notifications to

Step 3: Configure notifications

await nebutra.integrations.slack.configure({
  orgId: "org_123",
  channelId: "C0XXXXXXXXXX",
  events: [
    "member.joined",
    "quota.warning",
    "quota.exceeded",
    "invoice.paid",
    "invoice.payment_failed",
  ],
});

Notification examples

New member joined:

✅ Alice ([email protected]) joined Acme Corp as a Member.

Quota warning (80%):

⚠️ Acme Corp has used 80% of their monthly API quota (800/1,000 calls).
Consider upgrading to PRO for 100x more calls.

Invoice paid:

💳 Invoice #inv_123 paid — $29.00 for Nebutra PRO (March 2026).

Custom notifications

Send a custom Slack message from anywhere in your codebase:

import { slack } from "@nebutra/notifications";

await slack.send({
  channel: "C0XXXXXXXXXX",
  text: "A new project was created",
  blocks: [
    {
      type: "section",
      text: {
        type: "mrkdwn",
        text: `*New project created*\n${org.name} created "${project.name}"`,
      },
    },
  ],
});

Webhooks Guide

Build custom event-driven workflows.

Integrations Overview

All available integrations.