Agent setup guide
UGC Permission Requester
When someone tags your Instagram account, AI judges if the post is worth reposting and drafts a permission request; you approve it, get it in Slack to send, and every tag is logged.
What it does
When someone tags your Instagram account, AI judges if the post is worth reposting and drafts a permission request; you approve it, get it in Slack to send, and every tag is logged.
- Starts when someone tags your Instagram account in their public post (checked every 15 minutes or more).
- AI reads the caption, judges whether it's a genuine post worth reposting by your rules (spam, contests, resellers, complaints and posts about children are skipped), and drafts a short permission request that says how you'd credit them.
- You open the post and approve or edit the request; code checks it for length and placeholders, then it comes to your Slack channel with the post link, ready to paste as a comment or DM.
- Every tag is logged in your Google Sheet with the verdict, the request and your decision, with a Permission column for their answer.
What it needs
- A paid plan (agents run live on paid plans).
- An AI provider key (Settings → AI Providers).
- Instagram (a professional account linked to a Facebook Page), Slack and Google Sheets, connected in Settings → Integrations.
- A sheet with the header row Date | Creator | Post | Caption | Worth asking | Why | Request | Your decision | Note | Permission.
What it doesn't do
- It doesn't post the request on Instagram: Instagram's API doesn't allow comments on other people's posts or DMs, so you paste it.
- It can't read their answer or download and repost the content; you record the answer in the sheet.
- It sees the caption only, not the photo or video. Tags in stories aren't included.
Availability and plans
Coming soon — waiting for Instagram approval
The agent is built, but Instagram is still waiting for the vendor's approval. It becomes available on its own once that app is live; until then it can't be bought or set up.
Included free on the Enterprise plan; on other paid plans it's a one-time purchase per workspace (the price is on the Agents page). The Agents page in the app always shows its current status.
Before you start
- A paid plan: agents run live, and the Free plan only runs Dry Runs.
- An AI provider key (OpenAI, Anthropic, Google and more) in Settings → AI Providers. AI usage is billed by your provider.
- These apps, connected in Settings → Integrations: Instagram, Slack and Google Sheets.
- The app it watches, connected in Settings → Integrations (the agent starts from an app event).
- About 15 minutes.
Set it up step by step
Get the agent first (buy it, or it's already yours when your plan includes it), then in Agents → My agents press “Set up this agent”. That creates the agent's workflow in your workspace (it counts towards your plan's workflow limit) and opens the canvas with a setup checklist above it. Each item links to the exact place to go and ticks itself off when it's done.
1. Connect your AI provider
The AI steps run on your own key (OpenAI, Anthropic, Google and more). Add one in Settings → AI Providers.
2. Connect Instagram
Connect your professional Instagram account (linked to a Facebook Page) in Settings → Integrations → Instagram.
3. Connect Slack
Connect your Slack account in Settings → Integrations.
4. Connect Google Sheets
Connect your Google Sheets account in Settings → Integrations.
5. Pick your Instagram account
Open the trigger and pick your Instagram login and account.
| Setting | What to enter | In step |
|---|---|---|
| Instagram account | The professional Instagram account people tag. Pick your connected Instagram account. | “You're tagged in a post” |
| Account to watch | Pick your Instagram account. | “You're tagged in a post” |
6. Describe what's worth reposting
Open “Worth asking? Draft the request” and replace the placeholder with your rules.
| Setting | What to enter | In step |
|---|---|---|
| What's worth reposting | Replace the placeholder with your brand, what a post worth reposting looks like, what you never repost, your tone and how you credit creators. It starts as “[DESCRIBE YOUR BRAND, WHAT A POST WORTH REPOSTING LOOKS LIKE, WHAT YOU NEVER REPOST (E.G. CHILDREN, COMPLAINTS, COMPETITORS), YOUR TONE, AND HOW YOU CREDIT CREATORS (E.G. TAG THEM IN THE CAPTION)]” until you replace it. | “Worth asking? Draft the request” |
7. Pick your Slack channel
Open “Send it to you in Slack” and pick the workspace and channel.
| Setting | What to enter | In step |
|---|---|---|
| Slack workspace | The Slack workspace for permission requests. Pick your connected Slack account. | “Send it to you in Slack” |
| Slack channel | The channel where approved requests are posted for you to send. | “Send it to you in Slack” |
8. Pick your UGC sheet
Open “Log it in your UGC sheet” and pick the spreadsheet and tab (Date | Creator | Post | Caption | Worth asking | Why | Request | Your decision | Note | Permission).
| Setting | What to enter | In step |
|---|---|---|
| Google account (UGC log) | The Google account that can open the spreadsheet. Pick your connected Google Sheets account. | “Log it in your UGC sheet” |
| UGC log spreadsheet | Paste the link of the spreadsheet. | “Log it in your UGC sheet” |
| UGC log tab | The tab with the header row Date | Creator | Post | Caption | Worth asking | Why | Request | Your decision | Note | Permission. | “Log it in your UGC sheet” |
9. Test it with Dry Run
Press Dry Run: the agent runs on sample data with no messages sent and nothing written to your apps.
10. Switch the trigger on
Open the trigger and click “Activate app trigger”: new tags are checked every 15 minutes or more.
How it works
The agent is a normal workflow with 9 steps (1 AI step, with a person approving in Reviews). You can open, edit and monitor it like any other workflow.
- You're tagged in a post — Starts on “New tag (mention)” in Instagram (an app event). Starts when someone tags your Instagram account in their public post (checked every 15 minutes or more).
- Worth asking? Draft the request — AI step (runs on your AI provider key). AI judges from the caption whether the post looks like a genuine customer post worth reposting (by your rules) and drafts a short, friendly permission request that says how you'd credit them.
- Worth asking? — Decision: picks the branch to follow. Posts that aren't worth asking about are only logged.
- Approve the permission request — A person approves or rejects it in Reviews (the run waits). Branch: Ask. The post link and the draft request wait in Reviews: open the post, edit the request, approve to get it in Slack ready to post, or reject.
- Check the request — Step. Branch: Approved. In code: the request is there, fits 300 characters and has no leftover placeholders.
- Passed the checks? — Decision: picks the branch to follow. Passed: the request goes to Slack. Otherwise it's only logged.
- Send it to you in Slack — Slack: Post a message. Branch: Send to Slack. Posts the post link and the approved request to your Slack channel, ready to paste as a comment or DM on Instagram.
- Log it in your UGC sheet — Google Sheets: Add a row. Branch: Not worth asking / Rejected / Held. Adds a row to your UGC sheet for every tag (Date | Creator | Post | Caption | Worth asking | Why | Request | Your decision | Note | Permission); Permission is left for you to fill in when they answer.
- Logged — Kept in the run history. The run history keeps the assessment and the request.
Test it with Dry Run
Press Dry Run in the canvas. The agent runs on the sample data stored on its trigger (the “Sample data for Dry Run” box), so you can check every step's output before anything is live. The sample has the same shape as a real event from the app.
Sample data fields
caption, media_id, username, permalink, media_type, timestamp.
- Nothing is sent or written: app actions, emails and Slack posts are simulated, and AI steps don't call your AI provider.
- Approval steps use the Dry Run decision you pick in the step's settings (approved, rejected or timeout), so you can try each branch.
Go live
- Open the trigger and click “Activate app trigger”: new tags are checked every 15 minutes or more.
- Activating the app trigger needs the trigger's connected account. The first check only remembers what's already there, so older items don't start runs; the same item never starts two runs.
- The setup checklist adds a “paid plan” item before activation: live runs need a paid plan (the Free plan only runs Dry Runs).
- When every checklist item is done and the trigger is on, the checklist says “Live — this agent is running”. Follow its runs in the workflow's History tab and in Analytics → Agents.
Questions
Why doesn't it post the request on Instagram itself?
Instagram's API doesn't let apps comment on other people's posts or send DMs to them, so the approved request comes to you in Slack, ready to paste. It takes seconds and stays personal.
Does it record their answer?
Every tag gets a row with a Permission column: write yes or no when they reply. The agent can't read their reply.
Can it see the photo?
No, only the caption, username and post type. You open the post from the link before approving.
Troubleshooting
- “No AI provider connected” or a rejected key: connect or fix the key in Settings → AI Providers, then press Test there.
- A checklist item stays unticked: the setting is still empty or still contains its placeholder text. Open the step from the checklist and fill it in.
- An app step fails with “Needs reconnect”: the account's access was revoked or expired. Reconnect it in Settings → Integrations.
- Slack says the app isn't in the channel: in Slack, type /invite @Fluxo Flow in that channel (always needed for private channels).
- No runs start: activate the app trigger with a connected account. Only items created after activation start runs.
- A run shows as paused: it's waiting for someone in Reviews to approve or reject it.
- A step failed: open the run in History and check that step in the Trace tab for the error and what it received.
Generated from the agent's own workflow, so it always matches what the agent does. Last updated .