🔌 Connector Framework

Connectors That Grow With You

A reusable library of tenant-owned OAuth connections. Fire Slack, email, calendar, Sheets, or any future integration — in parallel with your AI agent workflows, with zero shared credentials and zero UI rebuilds.

The catalog grows without any UI change. Every new connector ships as a schema-driven operation — when Slack arrives, your admin sees it instantly.
3Providers live today
∞Operations extensible
0UI changes for new ops
⚡ Core Capabilities

Not Just Webhooks. A Full Connector Infrastructure.

Every capability below ships in production today. Expand each card to see the implementation.

🔌

Reusable Definition Library

Build once. Attach anywhere.

Every connector is a named, pre-configured operation with its parameters saved. Build a 'Send WhatsApp Confirmation' definition once, and every restaurant on your tenant attaches it with one click.

What's inside

  • ✓Tenant-scoped definitions published by the admin
  • ✓Per-app attachment — nothing auto-inherits
  • ✓Survives chain deletion — the definition stays
  • ✓Versioned, auditable, and CRUD-managed
  • ✓Fail-hard guards prevent deletion while apps use it
Proof: Definitions outlive the chains that reference them.
🔐

Enterprise OAuth Flow

Tenant-owned accounts. Zero shared credentials.

Each tenant brings their own Google Workspace, Slack, or HubSpot account. Sageion never sees a password — only an OAuth token, encrypted per-tenant, in its own Secrets Manager namespace.

What's inside

  • ✓PKCE + state + audience + issuer verification
  • ✓Refresh-token rotation with race-condition detection
  • ✓Revoke at provider AND delete locally
  • ✓Narrowed-scope propagation on refresh
  • ✓7-day grace window during token rotation
  • ✓Per-tenant secrets under {Prefix}/sageion/oauth-token/*
Proof: A CISO can audit exactly which secrets belong to which tenant.
⚙️

Schema-Driven Operation Registry

New connectors ship without any UI changes.

Every operation describes its own parameter schema. The admin's post-trigger editor generates the form from that schema. When we ship Slack or Stripe tomorrow, they appear instantly — no frontend deploy required.

What's inside

  • ✓Each operation declares its required scopes for pre-flight
  • ✓The admin renders the parameter form from the schema
  • ✓Scope checks run before the vendor API ever gets called
  • ✓Adding a new provider is a code change, not a UI rebuild
  • ✓Zero downtime when new operations ship
Proof: The catalog grows without touching the admin.
🛡️

Isolated Security Surface

Separate stack. Separate IAM. Separate secrets.

The connector handler runs on its own Lambda, its own API Gateway, its own SQS queue with DLQ, and its own IAM role. OAuth credentials never mix with tenant data. Credential rotation is one CloudFormation deploy.

What's inside

  • ✓Own Lambda with 60s timeout (vs AutoBot's 180s)
  • ✓Own SQS queue with 5-receive DLQ, 14-day retention
  • ✓Own Secrets Manager namespace for provider credentials
  • ✓Read-only IAM on AutoBot's data tables
  • ✓Narrow write IAM on connector's own tables only
  • ✓No shared environment variables with AutoBot
Proof: The compliance auditor sees two separate stacks, not one.
📦 Operations Catalog

Live Now — and Grown Every Week

Every provider below is a first-class operation. The admin's post-trigger editor auto-generates its form from the operation's schema.

📊Google Sheets● Live
  • append_rowAppend row to sheet
  • list_spreadsheetsList spreadsheets
  • list_tabsList sheet tabs
📧Gmail● Live
  • send_asSend email from connected Gmail
📅Google Calendar● Live
  • create_eventCreate calendar event
💬Slack◐ Shipping Soon
  • post_messagePost message to channel
  • send_dmSend direct message
📱WhatsApp◐ Shipping Soon
  • send_templateSend template message
  • send_mediaSend media message
💳Stripe◐ Shipping Soon
  • create_payment_linkCreate payment link
  • refund_paymentRefund a payment
🧲HubSpot◐ Shipping Soon
  • create_contactCreate contact
  • create_dealCreate deal
🔗Custom / REST○ Planned
  • any_http_endpointAny HTTP endpoint
Don't see your integration? Request it — every new operation ships without any change to the admin UI.
🔄 How It Works

From OAuth to Execution in Three Steps

1

Connect

The tenant admin clicks Connect Google (or Slack, or any future provider). PKCE, state, audience, and issuer are all verified automatically.

Token stored in {Prefix}/sageion/oauth-token/... — encrypted, tenant-scoped, never shared.
2

Define

The admin builds a named connector definition — e.g. "Send WhatsApp confirmation" — and fills in its parameters from the auto-generated schema form.

Definitions are tenant-scoped. Apps attach the ones they need. Nothing auto-inherits.
3

Fire

Attach the definition to any chain node or leadgen form. It fires to a separate SQS queue with its own DLQ, in parallel with the main flow.

A slow Slack API never delays a table booking. Failures go to the DLQ, not to the user.
🛡️ Security

Isolated by Design.

The connector stack runs on its own deployment — separate IAM, separate secrets, separate queue. OAuth credentials never mix with tenant data.

Separate Lambda

60-second timeout, narrow IAM, dedicated execution role. Cannot access AutoBot's data except through read-only paths.

Separate Secrets Namespace

Provider credentials live at {Prefix}/sageion/oauth-provider/*. Tenant tokens live at {Prefix}/sageion/oauth-token/*. Never shared.

Separate SQS Queue

With a dedicated DLQ. Failures retry 5 times, then archive to DLQ with 14-day retention — visible to operations, never to the end user.

Read-Only Cross-Domain Access

The connector can read -AutoBotData and -ScopeAttachments to verify ownership. It can never write to either.

🚀 Roadmap

Shipping Soon

Q1
  • Slack post_message, send_dm
  • WhatsApp template messages
Q2
  • Stripe payment links & refunds
  • HubSpot contacts & deals
Q3
  • Twilio SMS
  • Salesforce basic operations
Q4
  • Custom REST/HTTP endpoint operation
  • Generic webhook operation

Need a Connector We Don't Have Yet?

Every connector is a schema-driven operation — adding a new one never requires an admin UI change. Tell us which provider you need, and it ships in the next release.