Skip to content
Docs
About By Dawn Contact supportOpen By Dawn
  1. Integrations
  2. Connect your chat account

Connect your chat account

This page shows you how to link your chat account to your By Dawn account. Once it’s linked, a button you click or a command you run in chat acts as you: you can create tickets, comment, move cards and start workers without opening By Dawn.

You only need this to act. Anyone in a bound channel can file a request without linking (see Who may do what).

Before you start

Section titled “Before you start”
  • An org admin has connected your Slack workspace, Discord server or Microsoft 365 tenant to By Dawn. Settings shows each one you can link.
  • Link one chat account per By Dawn organization. By Dawn matches you by your chat user id, never by your display name.
Section titled “Link from By Dawn”

  1. Open Settings › You › Connections. Each connected workspace, server or tenant you haven’t linked shows not linked.

  2. Choose Link account next to it. By Dawn sends you to the platform to sign in:

    • Slack: Sign in with Slack.
    • Discord: Discord asks to share your username (the identify permission). You must be a member of the connected server.
    • Microsoft Teams: you sign in with your work account, which must belong to the connected tenant.

  3. Back in By Dawn, Link your chat account asks what By Dawn may do as you (see Scopes). Choose Link account.

Section titled “Link from chat”

Run /saw link in Slack or Discord, or send link to By Dawn in a Teams personal chat. By Dawn answers privately with Link my account. Open it while you’re signed in to By Dawn, then confirm the scopes as above.

The link is single-use and expires after 10 minutes, so ask for a new one if it has expired. It links the chat account to whichever By Dawn member opens it, so don’t forward it.

Scopes

Section titled “Scopes”

You choose these when you link, and you can change them any time under What SAW may do as you here:

Scope Lets chat… Starts
Tickets create and update tickets, comment, move cards and link threads on
Workers start and stop workers on
Answers approve plans, answer a worker’s questions and re-run CI on
Merge approve and merge pull requests, where the project allows merging from chat off

A scope never gives you more than your role does. If you can’t move a card in By Dawn, you can’t move it from chat either. Merge is off until you turn it on, because a merge ships code. Even then it only works where the project allows it (see Merging from chat).

At least one scope stays on. To turn everything off, unlink.

Section titled “When By Dawn asks you to link again”

You’ll see “SAW could not act for you: your Slack link no longer works” (or Discord, or Teams) when By Dawn can’t act as you any more. That happens if you unlinked, an admin removed you from the organization, or your role changed. Choose Link my account to link again. By Dawn never carries the action out some other way, for example with the channel’s authority.

If an org admin has to reconnect the platform, Settings says so on the link: This workspace needs an org admin to reconnect it before SAW works there again.

Section titled “Unlink”

Choose Unlink next to the account in Settings › You › Connections. By Dawn revokes what you let it do and deletes the link at once. In Teams, the help card’s Unlink button opens the same page.

Chat DMs

Section titled “Chat DMs”

Once an account is linked, you can get attention notifications as a direct message: a worker’s question, a permission request, a stalled run, or a finished one. Turn each one on under Settings › You › Notifications › Chat DMs. They start off, and your push and email settings don’t change. A DM goes to every chat account you’ve linked.

Where to go next

Section titled “Where to go next”