Hosted Actions

Hosted Actions are small automations that Delphi runs for you, on Delphi's own servers. If a webhook is about sending information out to another tool, a Hosted Action is the automation itself, living inside Delphi, so there is nothing for you to host or keep online. You set up the instructions once, and Delphi runs them reliably for as long as you want.

The real superpower is that an action can wait. Something like "wait three days after someone goes quiet, then send a friendly follow-up, unless they have already replied" is not possible with a plain webhook, but it is a natural fit here. Hosted Actions are great for follow-up sequences, recurring routines, and automatically tagging or syncing your audience, all without standing up a server of your own.

Three ways an action can run

An action can be triggered in three ways, and you can combine them:

• React to an event. It runs the moment something happens, using the same events as webhooks, like a conversation ending or a new contact arriving.
• Run on a schedule. It runs on a regular timer you set, for example every morning, which is perfect for a daily sweep or a recurring cleanup.
• Wait, then act. This is the durable option. The action can pause for anywhere from a few minutes up to a year, then carry on, even if something restarts in between. It is what powers "do this later, unless something changes first."

Once it runs, a Hosted Action can do real work on your behalf: tag and update contacts, send a message or generate text in your Digital Mind's voice, notify you when a human should step in, and securely connect to your other tools like your CRM.

How one gets built

You do not need to be technical to create one. The easiest path is to let an AI coding agent (like Claude Code) build it for you. Setup is mostly copy-and-paste and takes about a minute.

1. Install the Delphi tool. A one-line install of the Delphi command-line tool: npm install -g @delphiai/cli

2. Sign in. Connect it to your account: delphi login

3. Add the skill pack to your coding agent. This teaches your agent everything about the platform in one step: delphi skills install

4. Describe what you want, in plain English. For example, "build something that emails me whenever a new high-intent contact is captured." Your agent uses the skill pack to write and test the action, then pushes it to Delphi to go live, checking with you first.

5. Manage it in the Developer Platform. Once live, see each action's status, triggers, and schedule, turn it on or off, store any private keys it needs (like a CRM token), and watch every run in Activity.

Frequently asked questions

• Do I need to know how to code?

  Not necessarily. Building an action does take some code, but the skill pack lets an AI coding agent build it for you from a plain-English description. Either way, actions are built on a computer and pushed to Delphi, since there is no editor inside the app.
• How is this different from a webhook?

  A webhook sends each event out to a tool that you run and maintain. A Hosted Action is the automation itself, running on Delphi with no server for you to keep online, plus two things a webhook cannot do on its own: run on a schedule, and wait for hours or days before acting.
• Can an action really wait days before doing something?

  Yes. A durable action can sleep for up to a year and then pick up exactly where it left off. That is how "follow up in three days unless they reply" works, with nothing running or costing you anything while it waits.
• Is it safe to let Delphi run code for me?

  Yes. Each action runs in an isolated sandbox that can only reach Delphi and the specific outside services you have allowed. Your secrets stay encrypted, daily spending is capped, and any message it sends still respects each contact's consent.
• How do I turn one off?

  You can deactivate any action at any time from the Developer Platform. Its code is kept, it simply stops running, and you can switch it back on or delete it whenever you like.