Skip to main content
In Slack, each assistant can have its own Slack app. Flo, Poppy, and Penny then appear as separate members of your Slack workspace, each with its own name, picture, and direct messages. Every message runs as the person who sent it, with that person’s Floral access. The same approval rules apply as in the Floral app.

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.
1

Open Channel setup

In Floral, open Settings > Organization > Channel setup.
2

Generate a token in Slack

Open api.slack.com/apps and sign in to your Slack workspace. Under Your App Configuration Tokens, select Generate Token and choose your Slack workspace.
3

Paste the refresh token

Copy the refresh token, which starts with xoxe-1-, paste it into Slack key in Floral, and select Connect Slack.
The token lets Floral create, update, and delete your assistants’ Slack apps in your Slack workspace. Slack issues configuration tokens through its own app, Slack Tooling Tokens Vendor, so you may see that name in your Slack workspace’s app list. It belongs to Slack, not to Floral. You paste the token only once. Floral stores it encrypted and refreshes it automatically. One Slack workspace connects to one Floral organization. Only organization administrators can connect Slack, add or remove assistants, and disconnect Slack. If someone else manages your Slack workspace, share For Slack administrators with them. It lists what the token and each assistant app can do.

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

1

Add the assistant

Under Assistants in Slack, select Add to Slack next to the assistant. The status shows Creating… while Floral creates the Slack app, then Ready to install.
2

Install it

Select Install in Slack and approve the app in Slack. The status then shows the assistant’s Slack name, for example Installed as @flo.
Each Slack app gets the assistant’s name. If your Slack workspace already has an assistant with that name from another Floral workspace, the new one gets the workspace name in parentheses, for example Flo (Sales). Slack may also add a number to the handle, for example @flo2. A paused assistant can’t be added. Resume it first.
If your Slack workspace requires app approval, Slack shows Awaiting admin approval instead of installing. A Slack administrator approves the app in Slack. Then select Install in Slack again.
Floral sets each assistant’s picture in Slack. If Slack doesn’t accept it, the Channel setup page links to the assistant’s Slack app settings. Upload the picture there under Basic Information > Display Information. Slack’s free plan allows 10 custom apps per Slack workspace. When you reach the limit, the status shows Failed: followed by the reason. Remove an app you no longer need in Slack, then select Retry.

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.
Slack Enterprise Grid isn’t supported yet. Installing an assistant in an Enterprise Grid organization shows Couldn’t install the assistant. Slack Enterprise Grid isn’t supported yet. Install each assistant in the Slack workspace that is connected to Floral. Another Slack workspace shows Couldn’t install the assistant. Install it in the Slack workspace connected to Floral.

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 need reactions:write, which was added after the first assistants were installed.
1

Open Channel setup

In Floral, open Settings > Organization > Channel setup. An assistant that needs it shows Reinstall to grant new permissions. For a short while after an update it says instead that the Slack app is being updated and that reinstall will be available shortly. Wait until that changes.
2

Select Reinstall

Select Reinstall next to the assistant. Slack opens and lists the permissions, including the new one.
3

Approve in Slack

Select Allow. You return to Floral, and the note disappears. If your Slack workspace requires app approval, a Slack administrator approves the request first. Then select Reinstall again.
Reinstalling keeps the assistant’s name, picture, direct messages, channels, and every user’s link. Nothing needs to be invited or linked again. Repeat the steps for each assistant. An assistant app has no slash commands, no access to files, and no access to email addresses. It can’t join channels on its own. Someone must invite it. Slack sends each app the messages in channels it’s in. The assistant reacts only to:
  • 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.
It ignores every other message.

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 need the 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.
1

Message an assistant in Slack

Send the assistant a direct message, or mention it in a channel, for example @Poppy.
2

Open your personal link

The assistant replies with a sign-in link that only you can see. The link is for you alone and expires after 30 minutes. Don’t forward it.
3

Sign in to Floral

Sign in and select Connect. There is no workspace to choose: each assistant works in the Floral workspace it was added from.
4

Ask again

Send your question again. From now on, the assistant knows who you are.
You link once per Slack workspace. The same link works for every assistant there. If you message an assistant that belongs to a Floral workspace you don’t have access to, it says so. Ask a workspace administrator to invite you. Your linked Slack users are listed under Settings > Workspace > Assistants > Channels, in the section Connected users. You can unlink yourself there. Workspace administrators can unlink any user. If your access changes, the assistant asks you to link 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.
Only you see the answer. Others in the channel see your question, but not the reply.
  • 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.
With Team replies, everyone in the Slack channel can read the answers. That can include people who aren’t users in your Floral workspace, such as Slack guests. Use Team replies only in channels where everyone may see the workspace’s shared Floral data and the team accounts’ data.
Slack can remove private replies when you reload Slack or switch device. For an answer you want to keep, ask in a direct message with the assistant, or select Share in thread.

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. For the Floral app and routines, see “Who sees the answer?” in Use Floral’s assistants. For the difference between the two kinds of accounts, see Your account and team accounts.

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

Not in a lasting way. The name in Slack comes from the assistant in Floral, and Floral can overwrite a name changed in Slack the next time it updates the app. If the handle is already taken in your Slack workspace, Slack may add a number, for example @flo2. The name people see stays Flo.
Yes, when they belong to the same Floral organization. Each Floral workspace adds its own assistants. When a name already exists in Slack, the new assistant gets its Floral workspace’s name in parentheses, for example Flo (Sales). Each user links their Slack user once, and the link works for every assistant in that Slack workspace. An assistant answers only users in its own Floral workspace.
The workspace’s assistants stop working for them. When they message one, it says it works in a Floral workspace they don’t have access to. Nothing runs with their access. If they’re invited back, the assistant may ask them to link again. A workspace administrator can also unlink them under Settings > Workspace > Assistants > Channels.
Your Slack workspace requires a Slack administrator to approve new apps. Slack sends them the request, and the assistant isn’t installed yet. Its status stays Ready to install. After a Slack administrator approves the app, select Install in Slack again to finish.
Remove deletes only the assistant’s Slack app. The assistant stays in Floral, and its conversations stay saved there. Messages already in Slack stay in Slack. Removing the assistant from the workspace under Settings > Workspace > Assistants also deletes its Slack app. If you add the assistant to Slack again, it gets a new Slack app. Start a new direct message with it, and invite it to your channels again.

When something goes wrong

Send the assistant a direct message to get a personal link, then follow the steps under Link your Slack user.
The assistant belongs to another Floral workspace in your organization. Ask a workspace administrator to invite you.
An administrator paused the assistant in Floral. It answers again once they resume it.
The workspace hasn’t turned on assistants, or your access doesn’t include them. Ask a workspace administrator.
Wait a minute and try again.
Open the link in the message to see the saved work in Floral. Check any saved actions before you ask again, so nothing is done twice.
In a channel, an assistant only reacts to mentions and to your own follow-ups in a thread where you already talk to it. Check that it’s in the channel, then mention it again. If a private reply disappeared, ask again in a direct message with the assistant.
Requests must be shorter than 10,000 characters.

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.
Disconnecting Slack, removing an assistant, or unlinking your user stops future access. It doesn’t delete messages that Slack already stores.