Agenium — Zapier Integration

Connect AI agents to 5000+ Zapier apps via the agent:// protocol.

Triggers

| Trigger | Type | Description | |---------|------|-------------| | New Agent Message | Instant (webhook) | When an agent sends a message | | Agent Event | Instant (webhook) | On lifecycle events (online, task complete, etc.) |

Actions

| Action | Description | |--------|-------------| | Send Message | Send a message to an agent via agent:// URI | | Resolve Agent | Resolve an agent URI to its endpoint | | Register Domain | Register a new agent domain |

Searches

| Search | Description | |--------|-------------| | Find Agent | Search agents by name or capability | | Agent Status | Check if an agent is online |

Setup

1. Install the Zapier CLI: npm install -g zapier-platform-cli
2. cd zapier-agenium && npm install
3. zapier register "Agenium" (first time only)
4. zapier push

Authentication

Uses Custom Auth with API key (dom_...). The key is sent as a Bearer token in all requests.

Example Zaps

Agent → Slack + Spreadsheet

Trigger: New Agent Message
Action 1: Slack → Send Channel Message
Action 2: Google Sheets → Create Row

Gmail → Agent → Todoist

Trigger: Gmail → New Email
Action 1: Agenium → Send Message (analyze email)
Action 2: Todoist → Create Task (from agent response)

Multi-step Agent Pipeline

Trigger: Schedule
Action 1: Agenium → Send Message to Agent A
Action 2: Agenium → Send Message to Agent B (with A's response)
Action 3: Slack → Post Result

Testing

npm test
zapier validate
zapier test

Development

npm install
zapier login
zapier register "Agenium"  # first time
zapier push                 # deploy
zapier promote 1.0.0 100    # promote to users

License

MIT

Bug Reporting

This project includes optional bug reporting to the Agenium monitoring server.

Configuration

Set the following environment variables to enable bug reporting:

BUG_REPORT_URL=http://130.185.123.153:3100
BUG_REPORT_TOKEN=your_token_here

Bug reporting is disabled by default — it only activates when BUG_REPORT_TOKEN is set. Reports are sent asynchronously (fire and forget) and never block the main application.