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.
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.
The screenshots on this page use a made-up team and workspace, "Acme".
#Add Trina AX to Slack (the owner or an admin)
- 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 - Press Add to Slack
Add to Slack opens Slack's own page. It works on a phone too.
- 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.
- 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.
#Link your account and ask (everyone)
Each person links their own Slack account to their own Trina AX account, once. Nobody can link someone else.
- 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".
- 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.
- 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 - 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 ask | What 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 message | The 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.
What you need, all from your Slack app's settings at api.slack.com/apps
| Field in Trina AX | Where in Slack | Looks like |
|---|---|---|
| Bot User OAuth Token | Install App (or OAuth & Permissions), after Install to Workspace | xoxb-… |
| App-Level Token | Basic Information › App-Level Tokens › Generate Token and Scopes, with the scope connections:write | xapp-… |
| Client ID | Basic Information › App Credentials | numbers with a dot |
| Client Secret | Basic Information › App Credentials, Show | letters and numbers |
- 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.
- 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-. - 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 withxapp-. On the same page, under App Credentials, copy the Client ID and the Client Secret (choose Show first). - 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 see | What 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 error | The 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.
| What happened | What to do |
|---|---|
| Someone removed the app in Slack | Slack'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 while | Press Turn off. Trina AX stops answering in Slack; links stay. Turn on brings it back. |
| You want it gone | Press 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.