# Slack

Slack lets the agent tell your team about a call while it happens or right after: a new lead, a complaint that needs a person, a callback request. The agent writes the message and posts it to the channel you choose, so the right people see it without opening Voice Logica. Workflows can post to Slack as well, for example the details of every finished call.

The path is **Integrations - Catalogue - Slack - Authorize**. You add the Voice Logica app to your own Slack workspace; there is nothing to create or paste. One connection is shared by the whole company, and messages are posted as the **Voice Logica** app. Then turn the **Slack** tool on under the agent's **Skills - Tools & Workflows**.

## What you need before you start

- A Slack workspace, and permission to add apps to it. If your workspace asks an admin to approve apps, the admin approves **Voice Logica** first.
- For a private channel: someone in that channel invites the app to it, with `/invite @Voice Logica`. Public channels need no invitation.

## What you enter

After you allow the app in Slack, the **Slack** dialog opens:

- **Default channel** (required) — Where agents and workflows post when no channel is named. The list shows public channels, and private channels the app was invited to.
- **Send a test message** — Type a short line and click **Send test** to post it to the default channel.

On the agent's **Slack** tool card:

- **Operations** (required) — **Send to the default channel** (on by default) and **Send to a named channel**.

## First setup

1. **Integrations - Catalogue - Slack - Authorize**

   Slack opens. Pick the workspace at the top right if you belong to several, then click **Allow**. The **Slack** dialog opens when you return.

2. **Default channel**

   Pick the channel for alerts, for example your sales or front-desk channel.

3. **Send a test message**

   Type a short line and click **Send test**. It should appear in that channel within seconds. If it fails, see Troubleshooting before going further.

4. **My Agents - this agent - Skills - Tools & Workflows**

   Turn **Slack** on. Keep **Send to the default channel**, or add **Send to a named channel** when different situations go to different channels. Click **Save** on the card, then save the agent.

5. **Tell the agent when to post**

   In the agent's instructions, say what to post and where. For example: "When a caller asks for a quote, post their name, number and request to the #sales channel." The agent only posts when your instructions give it a reason.

6. **Prove it**

   Call the agent and ask for something that matches the rule. The message should land in the channel during or right after the call. If it does not, open the call in **Calls** and check whether the agent tried to post.

## Post every finished call to Slack

To send the details of each call to a channel without relying on the agent's instructions, use a workflow:

1. **Workflows - New workflow**, with the **Call Ends** trigger.

2. Add the **Slack - Send Message** node.

3. In **Message**, write the text and insert call variables from the picker, such as the caller's number and the call summary. Leave **Channel** empty to use the default channel, or type a channel name.

   Put each value on its own line, e.g. `Name: {{client_name}}`. When a call has no value for that line, the line shows `Name: —` instead of a bare label. A line made only of variables is left out when they are all empty.

4. Save the workflow and attach it to the agent.

## What it can do

- Post a message to the default channel, with no channel to choose.
- Post to a named channel, so one agent can send sales leads to one channel and complaints to another.
- In workflows: the **Slack - Send Message** node, with call variables in the message.
- Slack formatting works in the message: `*bold*` and `_italic_`.

The agent only sends. It does not read or answer conversations in Slack.

## Troubleshooting

**Why is my private Slack channel missing from the list?**

The app can only see private channels it was invited to. In that channel, type `/invite @Voice Logica`, then reopen the **Slack** dialog. Public channels always appear.

**Why does a Slack message fail with &quot;the Voice Logica app is not in that channel&quot;?**

The channel is private, or the app was removed from it. Invite it again with `/invite @Voice Logica` in that channel.

**Why does my Slack card ask me to reconnect?**

Someone removed the Voice Logica app from the Slack workspace, or its access was revoked. Open the Slack card under **Connected**, click **Disconnect**, then **Authorize** again from Catalogue and set the default channel. Posts fail until you do.

**Why was nothing posted to Slack after the call ended?**

Either the Slack tool is off on the agent, the agent was not saved after turning it on, or its instructions never say when to post. With **Send to a named channel**, the post also fails if the name in the instructions matches no channel or matches several: use the channel's full name.

**Why can't I add the Voice Logica app to Slack?**

Your Slack workspace requires an admin to approve apps. Ask a workspace admin to approve **Voice Logica**, then click **Authorize** again.

## Next Steps

[Get an integration working](https://docs.voicelogica.ai/integrations/) - connections and agent tools.  
[Google Chat](https://docs.voicelogica.ai/integrations/communication/google-chat/) - the same alerts in Google Chat spaces.  
[Tools & Workflows](https://docs.voicelogica.ai/agent-configuration/built-in-tools/) - turning tools on per agent.
