Connect Slack for the organization
An organization administrator connects Slack once. Floral then creates a Slack app for each assistant you add. To do that, Floral needs an app configuration token from your Slack workspace.Open Channel setup
Generate a token in Slack
Paste the refresh token
xoxe-1-, paste it into Slack key in Floral, and select Connect Slack.When Slack stops accepting the token
If Slack no longer accepts the token, the Channel setup page shows Slack no longer accepts the key. Assistants already in Slack keep working, but Floral can’t add or remove Slack apps until you reconnect. Generate a new token in the same Slack workspace, paste it, and select Reconnect Slack.Add an assistant to Slack
Add the assistant
Install it
Remove an assistant or disconnect Slack
- Remove next to an assistant deletes its Slack app. Users can no longer message that assistant in Slack.
- Disconnect Slack deletes every assistant’s Slack app from your Slack workspace. Users’ Slack links are kept, so they don’t need to link again if you connect the same Slack workspace later.
For Slack administrators
This section is for the person who manages your Slack workspace.The configuration token
- Floral uses the token only to create, update, and delete the assistant apps it makes in your Slack workspace. The token can’t read messages or change your Slack workspace’s settings.
- Floral stores the token encrypted and refreshes it automatically. No one needs to paste it again unless Slack stops accepting it.
- To stop Floral from managing apps, an organization administrator first selects Disconnect Slack in Floral. That deletes every assistant app. Then revoke the token on api.slack.com/apps under Your App Configuration Tokens.
- If you revoke the token without disconnecting, assistants already in Slack keep working, but Floral can’t add, update, or remove their apps. To remove an assistant then, delete its app in Slack.
What each assistant app can do
Each assistant app requests these Slack permissions:Reinstall an assistant to grant a new permission
When Floral adds a permission to the list above, each assistant already in Slack keeps working with the permissions it has. The feature that needs the new permission stays off for that assistant until an organization administrator reinstalls it. Emoji reactions needreactions:write, which was added after the first assistants were installed.
Open Channel setup
Select Reinstall
Approve in Slack
- Direct messages to it.
- Messages that mention it.
- Follow-ups in threads it already answers in. With Private replies, that’s the asking person’s own follow-ups. With Team replies, it’s every linked user’s.
While the assistant works
- A status line. As soon as the assistant picks up your message, Slack shows a short status under the conversation, such as Thinking…. In a direct message, and in a thread with Team replies, the status also says what the assistant is doing, for example Listing companies…. In a channel with Private replies it only ever says Thinking…, because everyone in the thread can see the status while only you see the answer.
- An 👀 reaction. The assistant adds 👀 to your message while it works and removes it when it answers. Others in a channel can see the reaction.
- Reactions instead of replies. When a reaction says it all, such as after “thanks”, the assistant may react with an emoji and write nothing.
- Staying quiet. With Team replies, the assistant reads every message in a thread it answers in. When people are talking to each other and nothing is for the assistant, it doesn’t reply.
reactions:write permission. If an assistant was installed before that permission existed, see Reinstall an assistant to grant a new permission. The status line works without it.
Link your Slack user
Message an assistant in Slack
Open your personal link
Sign in to Floral
Ask again
Direct messages
Each assistant has its own direct messages in Slack. Message Penny to talk to Penny. You don’t need to type her name. A direct message is private, just like the app. Only you see the conversation. The assistant can use your own accounts and the team accounts it is allowed to use. Conversations you start in Slack stay in Slack. The assistant’s page in Floral lists only conversations started in the Floral app. Approvals still open in Floral: select View in Floral or Review in Floral on an approval card.Mentions in a channel
Invite the assistant to the channel first, for example with/invite @Poppy. Then mention it. The answer depends on the assistant’s setting. An administrator chooses it for each assistant under Settings > Workspace > Assistants > Channels, in the section In channels. Direct messages are always private.
- Private replies
- Team replies
- When you mention the assistant inside a thread, the reply appears in that thread, visible only to you. When you mention it in a new message, the reply appears in the channel, visible only to you.
- The assistant uses your own accounts and the team accounts, as in a direct message. It knows other people are in the channel and says so when content comes from your own accounts, such as your email.
- Select Share in thread to post the reply for everyone in the thread. It appears as Shared by your name and the assistant’s name. Read it for personal details first. Approval cards are never shared, and the conversation stays yours.
- After you mention the assistant in a thread, your next messages in that thread reach it without a new mention. Messages from colleagues in that thread are ignored. If they mention the assistant, they get their own private conversation.
What each assistant can see
The rule: an assistant uses your own accounts, such as your email or calendar, only when you’re the only one who sees the answer. Team accounts work everywhere, but only those an administrator allowed for that assistant.Approve changes in Slack
When an assistant wants to change something, it pauses and Slack shows an approval card. The card asks a plain question, such as Send this? or Make this change?, and says what will happen and to what, for example Create invoice · Acme ApS. Below that it lists the change as labelled lines, such as the recipient, subject, and text of an email. It also shows the app and the account it uses, and whether that is Your account or a Team account. When a team account uses one person’s login, it also says Acts as and that person’s name or email. The buttons are Approve and run, Reject, and View in Floral.- Only the person who asked can approve. If someone else selects a button, nothing runs.
- A large change shows only Review in Floral. Approve it in the app, where you can see all of it. The card never shows part of a change next to an approve button.
- After you decide, the card changes in place. The buttons disappear, and the card says what happened and who decided, for example ✅ Approved by Maria.
- After you approve, the assistant continues with the next step. The next change needs its own approval.
- If the result is uncertain, Floral says so. Check the connected app before you try again.
Common questions
Can we rename an assistant in Slack?
Can we rename an assistant in Slack?
Can several Floral workspaces use the same Slack workspace?
Can several Floral workspaces use the same Slack workspace?
What happens when someone leaves the Floral workspace?
What happens when someone leaves the Floral workspace?
What does "Awaiting admin approval" mean?
What does "Awaiting admin approval" mean?
What happens to conversations when an assistant is removed?
What happens to conversations when an assistant is removed?
When something goes wrong
Your Slack account isn't connected to Floral yet
Your Slack account isn't connected to Floral yet
The assistant works in a Floral workspace you don't have access to
The assistant works in a Floral workspace you don't have access to
The assistant is paused
The assistant is paused
Assistants aren't available to you in this workspace
Assistants aren't available to you in this workspace
That's a lot of requests at once
That's a lot of requests at once
Sorry, I hit a problem on my side
Sorry, I hit a problem on my side
The assistant doesn't answer at all
The assistant doesn't answer at all
What the assistants never do
- Change anything without your approval on the approval card.
- Accept “yes” typed in a message as an approval, or let someone other than the requester approve.
- Post your private reply in the channel unless you select Share in thread.
- Use your own accounts for someone else, or in Team replies.
- Give you more access in Floral than you already have.
- Work in another organization or workspace than the one the assistant belongs to.
- Send email from Gmail. Flo prepares drafts only.
- Repeat a change on their own when the result is uncertain.
