Slack

Give an agent a voice in Slack without giving it the workspace. It posts and edits through named operations with a daily ceiling, and an edit can wait for a person.

Connect Slack Read the docs

Slacksecret · SLACK

host: slack.com
connect: Sign in, per user

Post message
slack-post-message
Update message
slack-update-message
Add reaction
slack-add-reaction
Set channel topic
slack-set-channel-topic

writes are off until switched on

Reads and writes in Slack. Writes are off until you switch them on.

Each one is a named operation from the pack. Reads change nothing.

Writes

Post message
read back
slack-post-message
Post one message to a public channel the app is in.
Update message
read back
slack-update-message
Replace the text of one message the app posted.
Add reaction
read back
slack-add-reaction
Add an emoji reaction to one message.
Set channel topic
read back
slack-set-channel-topic
Set the topic of one channel.
Set channel purpose
read back
slack-set-channel-purpose
Set the purpose of one channel.

Reads

How do users connect? Each one brings their own Slack.

1.Call for the userYour server invokes the action for the signed-in user. Without a Slack connection, the SDK throws EndUserNotConnectedError with a connect link.
2.The user pastes a keyThe link opens a form that shows where in Slack's settings to create the key. The link lasts 10 minutes and works once.
3.Anlyon checks itThe key is checked with Slack before it is kept, and bound to slack.com. It is never shown back.
4.Your server confirmsYour server confirms the connection for the user who is signed in, and the call goes through.

Guardrails. Suggested limits and approvals, for you to review.

Suggested limits

200 messages a day
100 edits a day
500 reactions a day

Suggested approvals

A person approves editing a message
A person approves changing a channel's topic
A person approves changing a channel's purpose

What the key must allow

Post messages as the app
Read public channels the app is in
Add and read reactions
Set a channel's topic and purpose

Good to know

Public channels only. The app's access does not cover private channels or direct messages.
Slack answers most refusals with a success status, so the read-back is what tells a post from a refusal.

For your own account

1.Open Actions, then Integrations, and choose Slack.
2.Press Connect. Slack's consent page opens and lists what Anlyon asks for.
3.Pick the workspace and approve. Add the app to each channel it should post in.
4.The workspace is now a secret named SLACK, bound to slack.com.

Slack in your code. For one of your users, or for your own account.

Act for one of your users from your server, or connect your company's own Slack with the CLI.

Read the guide

slack.ts

1import { Client, EndUserNotConnectedError } from "@anlyonhq/sdk";2345const anlyon = new Client({ apiKey: process.env.ANLYON_API_KEY! });6789try {1011  const { data } = await anlyon1213    .forUser(session.userId)1415    .actions.invoke("slack-post-message", {16      channel: "C0123456789",17      text: "Deploy finished."18    });1920  return { status: "done", grade: data.grade };2122} catch (error) {2324  if (error instanceof EndUserNotConnectedError) {2526    // The user connects their own Slack, then you call again.2728    return { status: "connect_required", url: error.connectUrl };2930  }3132  throw error;3334}

Other integrations. Under the same limits, approvals and receipts.

All integrations