Open app
Moonborn — Developers

Slack

Notification adapter — push Moonborn webhook events into Slack channels. Persona drift alerts to the QA channel, audit failures to engineering.

The Slack integration is a notification adapter. Moonborn emits a webhook event; the adapter formats it as a Slack message and posts to the channel you configured. It is not a full Slack app with slash commands or interactive components — that's out of scope for v1.

Setup

The integration wraps the standard webhook surface — there's no separate "install Slack app" flow. Two steps:

  1. Create an incoming webhook in Slack. In your Slack workspace: Apps → Incoming Webhooks → Add to Slack → pick the channel. You'll get a URL like https://hooks.slack.com/services/T.../B.../X....
  2. Subscribe a Moonborn webhook to that URL with a Slack-format transformer.
const hook = await client.webhooks.createWebhook({
  url: 'https://hooks.slack.com/services/T.../B.../X...',
  events: ['persona.audit_failed', 'persona.test_suite_failed'],
  description: 'Engineering Slack — quality alerts',
  format: 'slack', // tells Moonborn to send Slack-shaped payloads
});

The format: 'slack' flag (Team+) makes Moonborn serialize the event as a Slack Block Kit message instead of the raw JSON envelope. The formatted message includes the event type, persona name, link back to the persona detail in the product UI, and a quick action ("Open in Moonborn").

Channel routing patterns

Common splits:

  • #cx-quality — persona.audit_failed for support-facing personas (drift alerts that affect customer experience).
  • #brand-voice — persona.audit_failed for brand personas (variant drift).
  • #engineering-alerts — generation.run.failed for production generation failures.
  • #billing — subscription.upgraded/downgraded/cancelled.

One webhook per channel, scoped event lists. Easier to mute than filtering Slack-side.

Honest scope

Slack-as-receiver only. Moonborn does not currently:

  • Read messages from Slack.
  • Respond to slash commands.
  • Pair a persona with a Slack bot identity.

A Moonborn-driven Slack assistant (where users chat with a persona inside Slack) is on the roadmap but not v1. Today, Slack is a notification target.

Tier

Team and up (for the Slack format flag; raw JSON via Slack webhooks works at any tier with manual mapping).

Next