How to connect Arrows to Slack

Edited

The install takes about two minutes. You do it once per Arrows organization.

What the app does

Notifications. Arrows sends a direct message to a rep when:

  • a space is created for them,

  • a gameplan step is ready for them to review,

  • a visitor opens the sales room of their space,

Each message names the space, says what happened, and links back to Arrows. Each rep chooses which messages they get.

Slack tools for the agent. When a rep connects their own Slack, the agent can, as that rep:

  • search the public channels, and the private channels the rep is a member of,

  • read a channel or a thread,

  • find a teammate and read their name, title and email,

  • send or schedule a message, after the rep approves it in Arrows,

  • create a channel for a deal and invite people, after the rep approves it in Arrows.

The agent sees only what the rep can already see in Slack. It does not read direct messages. The app has no slash commands, and you cannot write to it.

Before you start

You need:

  • An Arrows account that belongs to an organization.

  • Permission to install apps in your Slack workspace. Ask a Slack workspace owner or admin if you are not sure.

Step 1: Open the Slack connector

In Arrows, click Connectors in the left sidebar. Then choose Slack.

Step 2: Click Add to your team

Click Add to your team. The Slack connector now shows On your team.

Step 3: Click Connect Slack

Under Company connection, click Connect Slack. Arrows sends you to Slack.

Step 4: Approve the permissions in Slack

  1. Check the workspace name in the top right corner. Change it if it is the wrong workspace.

  2. Read the list of permissions. See Permissions below for what each one is for.

  3. Click Allow.

If you click Cancel instead, Arrows returns you to the Slack connector and shows "Slack authorization was cancelled". Nothing is saved and you can start again.

Step 5: Check that Arrows is connected

Slack sends you back to Arrows. The company connection now shows Connected.

The install is done.

Step 6: Check that your reps will get messages

Arrows matches each Slack member to an Arrows user by email address. Arrows builds this list right after you connect, and again whenever someone joins your Arrows organization. You do not need to do anything.

If a rep's Slack email is different from their Arrows email, the rep opens User settings → Notifications, clicks Pick user in the Slack row, and chooses their Slack user.

Step 7: Choose your notifications

Each rep opens User settings → Notifications and turns each message on or off, for Slack and for email. Requests to connect a server always send.

Step 8: Connect Slack tools for the agent

  1. An admin opens Connectors → Slack and, under More Slack tools for the agent, clicks + on the Slack card.

  2. Each rep opens the Slack server page, clicks Connect Slack, reads the permissions, and clicks Allow.

Under Tool permissions, search and read tools are set to Allow. Tools that send a message or create a channel are set to Ask first, so the rep approves each one.

What the agent does with Slack

A rep asks the agent in a space, for example "What did we say about pricing in #deal-acme?". The agent searches and reads the channel, and answers in the space.

When the agent wants to send a message, it shows it to the rep first. The rep clicks Approve, and the message goes out as the rep.

What the messages look like

Arrows sends one short message per event. It is always a direct message from the Arrows app.

Arrows never sends an email, updates your CRM, or messages a customer for the rep without the rep's approval. The messages are written to make this clear.

Permissions

Arrows asks for these bot permissions when the app is installed:

Permission

What Arrows uses it for

chat:write

Send the direct message to the rep.

users:read

Read the list of members in your workspace, to find the rep.

users:read.email

Read member email addresses, to match each Slack member to their Arrows account.

Arrows asks for these user permissions only when a rep connects Slack tools for the agent. The agent uses them as that rep:

Permission

What the agent uses it for

search:read.public

Search public channels for what the rep asks.

search:read.private

Search the private channels the rep is a member of.

search:read.users

Find a teammate the rep names.

channels:read, groups:read

Find a channel the rep names, and list who is in it.

channels:history, groups:history

Read a channel or thread the rep points to.

channels:write, groups:write

Create a channel for a deal and invite people, after the rep approves.

users:read, users:read.email

Read a teammate's name, title and email.

chat:write

Send or schedule a message as the rep, after the rep approves.

Your data

Arrows stores the Slack tokens in encrypted form. It keeps your Slack workspace ID, and the Slack user ID, name and email of each member it matched to an Arrows account.

When the agent uses Slack content for a rep, Arrows keeps it as part of that rep's deal record. It is deleted when you delete the space, when you ask us to delete it, or when your organization leaves Arrows. Arrows never uses Slack data to train AI models. Read the privacy policy.

Arrows uses AI, which can make mistakes. Check important information before you act on it.

Remove the app

  1. In Slack, click your workspace name.

  2. Go to Tools & settings → Manage apps.

  3. Find Arrows and click it.

  4. Click Remove App.

Arrows stops sending messages as soon as you do this, and every rep's Slack tools in that workspace are disconnected. To also delete the data Arrows keeps, email help@arrows.to.

If something goes wrong

Message

What to do

Slack authorization was cancelled.

You clicked Cancel in Slack. Click Connect Slack again.

Invalid or expired OAuth state.

The install took more than one hour. Click Connect Slack again.

OAuth session did not match your login.

You signed in as a different user part way through. Sign in again, then click Connect Slack again.

You don't have access to this organization.

Your Arrows account is not a member of this organization. Ask an admin to add you.

Arrows could not load the tools from Slack.

Click Try again. If Slack's message says the app is not approved, ask your Slack admin to approve Arrows.

Slack is not configured.

This is a problem on the Arrows side. Email help@arrows.to.

For anything else, email help@arrows.to.