Skip to content
EN
Open app

For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/integrations/communication/slack.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.

Slack

5 min read
Copy as Markdown
View as MarkdownOpen the raw .md file.md

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.

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

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

Default channelREQUIRED
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:

OperationsREQUIRED
Send to the default channel (on by default) and Send to a named channel.
  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.

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.

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

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 "the Voice Logica app is not in that channel"?

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.