Skip to main content
Connect your agents and Coworker to Slack so your team can get work done from the tool they already use. DM the Pinkfish app from your laptop or phone, drop in files or questions, and an agent replies in the thread — with a written answer, any files it produced, and links to rendered web-app visualizations for data that deserves more than text.

​
Key Features

Chat from any device

Reach your agents from the Slack desktop, web, or mobile client. Great for quick requests while you’re away from the Pinkfish app.

Per-agent or org-wide

Enable Slack on one agent at a time, or turn it on for the whole organization and opt individual agents out.

Upload files into the chat

Drop images, PDFs, CSVs, or documents into the thread and the agent can read and act on them.

Rich responses

Agents post answers in-thread, upload generated files, and share rendered web apps as links you can open in a browser.

​
How It Works

  1. Install the Pinkfish Slack app into your workspace via OAuth. You can connect one agent at a time, or enable Slack for the entire organization.
  2. Open a DM with the Pinkfish app in Slack.
  3. Send a message. Pinkfish identifies you by the email on your Slack profile and matches it to your Pinkfish account. On your first message, the app walks you through any account, organization, or agent selection it needs.
  4. The agent runs. Pinkfish posts a short “thinking” note in the thread so you know the request was received, then replies with the full answer once the agent is done.
  5. Outputs flow back. Short text answers appear as Slack messages, generated files upload to the thread, and rendered HTML artifacts come through as shareable links that open the web app in your browser.
Slack DM with the Pinkfish app: a user asks for a 360° view of an account and the agent replies in the thread with a summary and a link to a rendered dashboard The “thinking” message posts within a second or two of your request, so you always know your message was received: Short "Let me think for a second…" acknowledgement posted by the Pinkfish app immediately after the user's message

​
Enabling Slack for an Agent

Open the agent you want to reach from Slack and go to the Channel section of the agent editor. Agent editor Channel tab showing the Slack toggle card alongside Microsoft Teams and External channels
  1. Toggle Slack on.
  2. A browser popup redirects you to Slack to authorize the Pinkfish app in your workspace.
  3. Approve the requested permissions. Slack returns you to Pinkfish, and the agent is now reachable from a DM in that workspace.
  4. The Pinkfish app sends you a welcome DM confirming the connection.
To disconnect, toggle Slack off on the same card. This removes the channel binding for the agent; it does not uninstall the Slack app from the workspace.

​
Organization-wide Slack

If your organization has Slack enabled globally, every published agent is reachable from Slack by default. The per-agent Slack toggle flips to an opt-out control: leave it on to keep the agent available in Slack, or turn it off to hide just that agent. Settings → Agents page showing the Channels section with a Slack toggle that enables all published agents in the org's Slack workspace Admins turn this on under Settings → Agents → Channels. It’s useful when most of your team works from Slack and you’d rather whitelist exceptions than opt each agent in one by one.

​
Threads and Conversations

Pinkfish treats Slack threads as chats.
  • Start a new conversation by sending a new top-level message in the DM. Each new thread starts a fresh chat with a clean context.
  • Continue a conversation by replying inside an existing thread. The same agent keeps the context of everything that was said.
  • Switch agents by starting a new thread. You can’t swap agents inside an existing thread.

​
Picking an Agent

When you send a new message, Pinkfish routes it one of two ways:
  • If the DM is wired to a specific agent, that agent answers.
  • Otherwise, Pinkfish picks the best match from the agents available in your organization and runs it.
If you want to choose the agent yourself, start a new thread and send list agents. Pinkfish replies with a dropdown labeled Select Agents… listing every agent you have access to; pick one and it handles the thread. The Pinkfish app's response to list agents: a Select Agents… dropdown showing the agents the user can route the thread to If you belong to multiple Pinkfish organizations, the app asks which one you want to use on your first message — you’ll see a dropdown labeled Select organization. To change it later, start a new thread and send switch orgs. Select organization dropdown posted by the Pinkfish app when a user belongs to more than one Pinkfish org

​
Built-in Commands

Pinkfish recognizes a few plain-text phrases as commands when they’re the first message in a new thread:
CommandWhat it does
helpPosts a short help message with tips on picking agents and switching orgs.
list agentsShows a dropdown of agents you can route the thread to.
switch orgsLets you switch the Pinkfish organization this thread is associated with.
These aren’t Slack slash commands — just type them as a normal message. The Pinkfish app's response to the help command, listing tips on picking agents and switching orgs

​
Uploading Files Into the Chat

Drop files into the Slack DM the same way you’d share them with a teammate — drag them in, paste an image, or use Slack’s + attachment button — and send a message alongside. Pinkfish downloads the attachments and hands them to the agent, so you can ask things like “Summarize this contract” or “Extract the line items from this invoice.” Common file types work: images (PNG, JPG), PDFs, CSVs, spreadsheets, and text documents. Individual files up to 50 MB are supported. A Slack DM where the user has attached a file alongside a question, and the Pinkfish app replies with a summary based on the attachment

​
Rich Responses

​
Formatting

Agents write in Markdown, and Pinkfish renders responses using Slack’s native formatting:
  • Bold and links show up as Slack-formatted text.
  • Headings become bold section labels.
  • Code blocks and inline code are preserved as monospace.
  • Markdown tables are rendered inside code blocks so columns stay aligned in Slack.

​
Files and artifacts

OutputHow it appears in Slack
Short textPosted as a regular Slack message in the thread.
Generated files (images, PDFs, CSVs, spreadsheets, etc.)Uploaded to the thread as Slack file attachments.
Rendered HTML web appsPosted as shareable links that open the web app in your browser.
A rendered HTML web-app artifact opened from a Slack link, showing charts and interactive visuals Web-app artifacts stay interactive — they aren’t flattened to images — so charts, filters, and other controls still work when you open the link.

​
Approving Tools

When an agent needs to use a tool for the first time, Pinkfish asks for approval right in the thread. You’ll see a prompt like 🔧 Tool Approval Required along with four buttons:
  • Reject — cancel the tool call
  • Approve Once — allow just this call
  • Approve for this chat — allow this tool for the rest of the thread
  • Approve always — allow this tool in any future Slack conversation
Tool Approval Required prompt in a Slack thread, showing the four approval buttons the user can choose from If a tool needs to be linked to a specific connection (for example, which Google account to use), Pinkfish shows a dropdown to pick the connection. If the right connection isn’t set up yet, you’ll be pointed back to the Pinkfish web app to complete the setup and then return to Slack.

​
Notes

  • The Pinkfish Slack app authenticates you using the email on your Slack profile. Make sure that email matches the one on your Pinkfish account.
  • Each agent connects to a single Slack workspace per organization.
  • The app only responds in direct messages. Mentioning the Pinkfish bot in a channel or adding it to a channel has no effect.
  • The Slack Channel is a separate feature from the Slack MCP server, which lets agents act on Slack as a tool (posting to channels, reading messages, and so on). The two can be used together.
  • If your team uses Microsoft Teams instead, see Microsoft Teams for the equivalent integration.
  • For other ways to start a workflow or agent, see Triggers. For Coworker inside the Pinkfish app, see Coworker.