@Foxley in any channel or run slash commands like /foxley to analyze ad performance, dig through your creative library, and — when an admin enables it — launch and update Meta campaigns without leaving Slack.
Install Foxley in your workspace
You need:- An Outfox account in the organization you want Slack tied to.
- Permission to install Slack apps in your workspace (or an admin willing to approve it).
Steps
Start the install
Sign in to Outfox at
app.outfox.ai, go to Settings → Integrations, and click Connect Slack on the Slack card. (Or visit app.outfox.ai/integrations/slack and click Add to Slack.)Approve in Slack
Slack asks which workspace to install Foxley in and lists the permissions Foxley is requesting. Approve to continue.
Link your Slack account to your Outfox account
The install above connects the workspace. Each individual Slack user who wants to use Foxley also needs to link their Slack identity to their Outfox account. This is a one-time, per-user step.Run /foxley-brands once
In any Slack channel where Foxley is available, run
/foxley-brands. Foxley sends you a private message containing a one-time link.Sign in to Outfox
Click the link. You’ll go through Outfox sign-in (if you’re not already signed in) and a confirmation page.
Slash commands
| Command | What it does | Who can run it |
|---|---|---|
/foxley | Ask Foxley a question. Posts the answer publicly in the channel. | Anyone linked |
/foxley-channel | Set the default brand for the current channel. | Slack workspace admin or owner (checked live) |
/foxley-brand | Set the default brand for the whole workspace. | Slack workspace admin or owner (checked live) |
/foxley-use | Set your personal active brand. Overrides channel and workspace defaults. | Anyone linked |
/foxley-brands | List the brands available in your organization. | Anyone (also triggers the link flow if unmapped) |
/foxley-reset | Clear your personal active brand. Falls back to channel or workspace default. | Anyone linked |
@Foxley in any channel Foxley is a member of, or message Foxley directly. Both behave like an interactive /foxley and stay in thread.
Inline brand override
If you want to ask Foxley about a different brand for one question only, prefix the question with--brand=<name>:
Brand context
Most Foxley questions need a brand context to answer well (“our spend” → spend for which brand?). Foxley resolves the brand in this order:- The
--brand=<name>override on the current message. - The personal active brand you set with
/foxley-use. - The default brand for the current channel (set by an admin with
/foxley-channel). - The default brand for the whole workspace (set by an admin with
/foxley-brand). - None — Foxley will ask you which brand to use.
#acme-ads, Beta to #beta-ads, and questions in each channel resolve correctly without anyone retyping the brand.
What Foxley can do
By default Foxley is read-only. It can answer questions, surface inspiration, and run any of the Meta Ads reporting tools — but it can’t create or modify campaigns, ad sets, ads, audiences, or attribution settings.Read-only tools (always available)
- Brand and creative reads — list brands, get a brand, list creatives, get a creative, search the inspiration library, generate a creative brief from a winning ad.
- Meta Ads reads — campaign / ad set / ad / creative metadata, insights (spend, CPC, CPM, CTR, conversions, etc.), audience overlap, attribution diagnostics, catalog reads, dataset stats.
- Foxley-only diagnostics —
analyze_acquisition_vs_harvestfor spend-classification analysis.
Mutative tools (off by default; admins can enable)
When an Outfox org admin flips on the Allow mutative Meta Ads tools toggle in Settings → Integrations → Slack, the following become available:- Create a campaign, ad set, ad, or creative.
- Activate or pause an entity.
- Update attribution mode on an ad account.
- Create a product catalog or product set.
users.info on every turn. A user who’s a Slack member, or whose Outfox org membership was revoked, can’t trigger mutations even if the workspace toggle is on.
Settings and admin controls
Open Settings → Integrations → Slack in the Outfox web app to:- See the linked workspace, install date, and bot scopes.
- Toggle Allow mutative Meta Ads tools on or off (Outfox org admin only).
- Disconnect the workspace. Hard-deletes Foxley’s data and revokes its bot token immediately.
Limits and rate caps
| Limit | Default | What happens when you hit it |
|---|---|---|
| Foxley turns per user per workspace | 30 / minute | You get a visible “wait ~Ns” message in-thread. |
| Tool steps per single Foxley turn | 8 | Foxley stops after step 8 and answers with what it has. |
Privacy and security highlights
- Bot tokens are encrypted at rest with AES-256-GCM.
- Webhook requests from Slack are HMAC-verified with a 5-minute replay window.
- Channel history is only read for threads Foxley is mentioned in. Foxley does not crawl channels it hasn’t been added to.
- No persistent Slack message storage today. Active turns live in process memory and in Foxley’s thread cache; no long-term database persistence in v1. The thread cache does not have an explicit per-key TTL yet.
- Org membership is re-checked on every turn. A user removed from your Outfox organization loses access within about a minute, regardless of their Slack mapping.
support@outfox.ai.
Troubleshooting
”This workspace isn’t linked to an Outfox organization yet”
The Slack workspace doesn’t have a Foxley install. Ask an admin to install Foxley by going to Settings → Integrations in Outfox and clicking Connect Slack.”Please link your Slack account to use Foxley”
You haven’t completed the per-user link flow. Run/foxley-brands and click the private link Foxley sends you.
”Your access to this Outfox organization has been revoked”
Your Clerk org membership was removed. Ask an admin to re-add you to the Outfox organization, then run/foxley-brands again to re-link.
Foxley refuses to create a campaign even though the toggle is on
Two checks gate mutations. Both have to pass on the same turn:- The workspace’s Allow mutative Meta Ads tools toggle must be on (set by an Outfox org admin in Settings).
- The Slack user invoking the mutation must be a Slack workspace admin or owner. Slack members can’t trigger mutations even when the workspace toggle is on.
”You’re sending messages a little too fast”
You hit the 30-turns-per-minute limit. Wait the suggested number of seconds and try again.Coming soon
- Thread browsing in the web UI. Slack-originated conversations will show up in the Outfox web chat history alongside web-originated chats.
- Tighter prompt-injection fencing for brand-context fields admins enter in Outfox.
- Per-user account unlink as a self-serve action.