Agents
Deploy ready-made agents to your own Supabase project. They run on your code, cost nothing to host, and talk only to SwooshConnect's API.
Could not copy. Use View as Markdown instead.
On this page
What an agent is
An agent is your own code running on your own Supabase project. SwooshConnect deploys it for you, but it is yours: the function, the tables and the schedule all live in your project, and hosting it is free.
An agent never talks to Google, Facebook, Instagram or TikTok directly. It reaches your connected accounts only through SwooshConnect's API at https://swooshrank.com/api/v1, using a key created for that one deployment.
Deploy from the portal
- Open Agents in the portal at https://swooshrank.com/portal/connect and connect a Supabase account if you have not yet.
- Pick the agent you want, then choose your Supabase account and the project to deploy into.
- Fill in the agent's settings (see below).
- Press Deploy. If you cannot yet, the hint under the form lists exactly what is still missing, for example a project or a setting.
Deploying creates the tables, the function and its schedule in your project, and creates an API key for this agent. That key can reply and post on your connected accounts.
Settings: secret or visible
Every setting is stored as a secret in your Supabase project. Keys and tokens are entered in a hidden field. Plain settings, such as what to post about or a campaign id, are shown as normal text so you can read and change them.
Agents that use an AI model let you pick a saved AI key from your connected accounts instead of pasting one again. Or choose to enter a key for this agent only.
Schedules
Each agent runs on a cron schedule set up in your Supabase project. The schedule is part of the template and is listed on each agent's page.
| Agent | Schedule |
|---|---|
| Review Reply | Every 15 minutes |
| Social Autopilot | Daily at 15:00 UTC |
| Review to Post | Every 6 hours |
| Voice Agent | Every 5 minutes |
Status, refresh and remove
- Deployments lists each agent with its project and status: Deploying, Live, Failed or Removed.
- Refresh status re-checks the function and schedule in your project.
- Remove asks you to Confirm remove, then revokes the agent's key first, so it can no longer act, and tears down its schedule and function. Your tables and their data stay in your project.
Customise your copy
The template is your copy. Change how it behaves by editing supabase/functions/run/index.ts, then redeploy. An AI coding assistant can do this for you: each template ships AGENTS.md and CLAUDE.md with the rules it must follow.
One key per agent
Each deployment gets its own API key. Removing the agent revokes it, and a failed deploy does not leave a live key behind. Your other agents and your own integrations are not affected.
Templates
- Review Reply: replies to strong reviews and drafts the rest.
- Social Autopilot: publishes one post a day.
- Review to Post: turns great reviews into thank-you posts.
- Voice Agent: feeds consented leads to your AI caller.
You pay for what you connect. Nothing else.