Connect apps

Slack

Add the Trina AX app to your Slack workspace once, then everyone asks Trina AX in a channel or a DM, with their own permissions.

With Slack connected, people ask Trina AX without leaving Slack: mention @Trina AX in a channel, or send it a direct message. Each question runs as the person who asked, with their own folder permissions, AI engine and limits, and the whole answer is also kept as a chat in Trina AX.

It takes two short steps. The team's owner or an admin adds the app to Slack once, and each person links their own Slack account once.

Tip

What you need

  • To add the app (once): the team's owner or an admin in Trina AX, and someone who can approve apps in your Slack workspace (a Slack workspace admin or owner). Nothing to copy or paste.
  • To link your account (each person, once): your own Slack account. Nothing to copy or paste.
  • Only on a server without Add to Slack: four values from your own Slack app, see below.
Note

The screenshots on this page use a made-up team and workspace, "Acme".

#Add Trina AX to Slack (the owner or an admin)

  1. Open Slack in Admin › Connected apps

    In Admin, choose Connected apps. Slack is one of the services there: under Discover until it is added, then under Connected. The team's owner and admins see it.

    Admin › Connected apps, with Slack under Discover

    Choose Slack. Its page shows Add Trina AX to Slack.

    Admin › Connected apps › Slack, before it is added
  2. Press Add to Slack

    Add to Slack opens Slack's own page. It works on a phone too.

  3. Choose your workspace and allow it

    Slack's page names the workspace in its top right corner and lists what Trina AX can see and do there. Check the workspace first: Slack opens on the workspace you used last, which may not be the one you mean. Switch it in that corner if needed, then choose Allow.

  4. You're back on Slack's page in Trina AX

    It says "Added to Slack. Invite the app to the channels where people will use it." The line shows your workspace and the app, Connecting for a few seconds, then Connected. There is nothing to copy or paste. While Trina AX waits for Slack's window, Try again and Cancel are there; the wait ends by itself after five minutes.

    Added and connected

Only a Slack workspace admin or owner can add the app. Anyone else comes back to "A Slack workspace admin has to add it. Ask an admin to do it.", and the app is taken off the workspace again.

#Invite the app to channels

Slack tells Trina AX only about the channels it is in. In each channel where people will ask, type:

/invite @trina-ax

Direct messages need no invite.

Each person links their own Slack account to their own Trina AX account, once. Nobody can link someone else.

  1. Ask in Slack

    Mention @Trina AX in a channel it was invited to, or send it a direct message. For example: "@Trina AX summarize last week's notes in shared/sales".

  2. Connect your account the first time

    The first time, Trina AX answers only you: "To ask Trina AX here, first connect your Trina AX account. The link works once, for 10 minutes, and only for you." Choose Connect Trina AX account. Trina AX opens (sign in if it asks) and shows both accounts. Link links them when your Slack account has the same e-mail as your Trina AX account. If it doesn't, the page says why and offers Sign in with Slack to link instead.

  3. Or link from Trina AX

    Settings › Connectors has a Slack line: "Sign in with your Slack account of … to link it." Link takes you to Slack and back, and the line then shows the account it is linked to.

    Settings › Connectors, Slack linked
  4. Ask again

    Go back to Slack and ask your question again. From now on Trina AX answers right away.

#Where the answer comes

Where you askWhat you get
A channel"Working on it…" and then the answer, shown only to you, with Post to channel. Press it to post the answer to the thread, with "Asked by" and your name.
A direct messageThe answer, in the thread of your message.
  • Go on in the same thread. Mention the app again in that thread, or reply in the DM thread: it continues the same chat. A new thread starts a new chat.
  • In your language. Trina AX's own lines in Slack ("Working on it…", "Answering as …", "Open in Trina AX") are in your Trina AX language. The answer itself follows the language you chose for AI answers.
  • The whole answer is in Trina AX too. A long answer is shortened in Slack, with a link to the rest. "Working on it…" also names the account it answers as, so you can tell it's yours.
  • Before you post. If the answer used a place not everyone on the team can see, such as a group's folder or your own folder, Post to channel first asks you to confirm, with Post anyway and Cancel. In a channel shared with another organization, answers are never posted.

#If Add to Slack isn't there

Add to Slack appears where the Trina hosting service serves your server: a hosted team, or a server you installed yourself that the hosting service has registered. Anywhere else, Slack's page in Admin › Connected apps shows Connect a Slack app instead: four steps to make your team's own Slack app from our manifest and paste its keys. Only the team's owner can do this, because it means pasting the app's keys; an admin sees "Only the team owner can connect Slack here." Open the page at your team's https:// address: people's Sign in with Slack links come back there.

Connect a Slack app
Tip

What you need, all from your Slack app's settings at api.slack.com/apps

Field in Trina AXWhere in SlackLooks like
Bot User OAuth TokenInstall App (or OAuth & Permissions), after Install to Workspacexoxb-…
App-Level TokenBasic Information › App-Level Tokens › Generate Token and Scopes, with the scope connections:writexapp-…
Client IDBasic Information › App Credentialsnumbers with a dot
Client SecretBasic Information › App Credentials, Showletters and numbers
  1. Create the app in Slack

    Choose Create the app in Slack. Slack opens "Create an app" with everything filled in from our manifest. Pick your workspace and choose Create. It makes an app for your workspace only.

  2. Install it in the workspace

    Choose Install it in the workspace (Slack's Install App page), then Install to Workspace and Allow. Copy the Bot User OAuth Token, which starts with xoxb-.

  3. Make the app token and copy the app credentials

    Choose Make the app token and copy the app credentials (Slack's Basic Information page). Under App-Level Tokens, choose Generate Token and Scopes, give it any name, add the scope connections:write, and choose Generate. Copy the token, which starts with xapp-. On the same page, under App Credentials, copy the Client ID and the Client Secret (choose Show first).

  4. Paste them and turn on

    Paste the four values into their fields and choose Check and turn on. Trina AX checks them with Slack. A value Slack refuses is named under its own field, with the Slack page where you fix it.

Then invite the app to channels as above. Details for operators: Setting up the team's own app.

What you seeWhat to do
"This is not a bot token." or "Slack does not accept this token."Copy the Bot User OAuth Token (xoxb-) again from Install App, with Slack's copy button.
"Slack does not accept this app token."Make a new App-Level Token with the scope connections:write and paste it.
"The two tokens belong to different Slack apps."Both tokens must come from the same Slack app.
"This is not a Client ID." or "This is not a Client Secret."Copy them again from Basic Information › App Credentials; the two fields may be swapped.
"Turn on Slack app settings › Socket Mode."The manifest turns it on; if someone turned it off, turn it on again in Slack.
Sign in with Slack fails with a redirect errorThe page was saved from another address than the team's https:// one. Open it at the team's address and save again.

You also see the four steps when your team's own Slack app is set up already. To switch, the owner removes it first (Replace tokens, then Remove Slack), then presses Add to Slack. An admin can turn the team's own app off and on, but only the owner can change or remove it. If Slack isn't in Admin › Connected apps at all, you aren't the team's owner or an admin: ask them.

#Remove or reconnect

Slack's page in Admin › Connected apps always says where things stand, and its row in the list shows the same state: On, Connecting, Off or what needs you. If Slack has not answered for a few minutes, the page says Not answering, with what to do. When the app was removed in Slack, the row says Reconnect and the page offers Add to Slack again, or Remove Slack if you don't want it back.

After the app was removed in Slack
What happenedWhat to do
Someone removed the app in SlackSlack's page says "The app was removed from Slack. Add it to Slack again." Press Add to Slack again. People's links stay: added to the same workspace, nobody links again. If you don't want it back, press Remove Slack instead: Slack goes back under Discover and everyone's account links are deleted.
You want it off for a whilePress Turn off. Trina AX stops answering in Slack; links stay. Turn on brings it back.
You want it gonePress Remove Slack and confirm. The app is taken out of your Slack workspace and everyone's account links are deleted. If you add it again later, everyone links again.

Anyone can Unlink their own Slack account in Settings › Connectors, on the Slack line, at any time.

#FAQ

#Who can add Trina AX to Slack?

The team's owner or an admin presses Add to Slack in Trina AX, and in Slack it has to be allowed by an admin or owner of the workspace. Admins can also turn it off and on, add it again, and remove it. Setting up your team's own Slack app (pasting its keys) is for the team's owner only. Members never see Admin; they link their own Slack account in Settings › Connectors.

#Does each person have to sign in?

Yes, once. Until a person has linked their Slack account, Trina AX only sends them the link to connect. A person whose Trina AX account is disabled or deleted is unlinked at once.

#What does Trina AX see in Slack?

Messages that mention @Trina AX in channels it was invited to, and direct messages sent to it. When you ask in a thread, the AI also reads that thread. When you ask it to, it can read a channel or thread the app was invited to and you are in. Messages from other apps there, such as form or monitoring alerts, come with their details. It doesn't read files, and it can't read channels the app wasn't invited to. To link accounts and to say who asked, it reads people's names and e-mail addresses in the workspace. In a channel, an answer is shown only to the person who asked until they post it.

#Whose permissions does an answer use?

The asker's: their folder permissions, their AI engine and their limits. The answer counts in their usage, as any chat does.

#Can we connect more than one workspace?

No, one workspace per team. A workspace already connected to another team is refused: "This Slack workspace is connected to another team. Remove it there, or remove the app in Slack, then try again." People of another organization in a shared channel, and bots, get no answer.

Full details: Slack connector.

Trina AX is free software under AGPL-3.0-only. Icons: Lucide (ISC). Edit this page