Foundations
Architecture
How the pieces fit — from webhooks to CRMs to AI agents.
System overview
At the highest level, every SyntheStudio automation is one of three shapes:
1. Event → workflow → system-of-record (a WhatsApp message arrives; an agent qualifies; HubSpot is updated). 2. Schedule → sweep → notify (every 15 minutes, pull reviews; escalate the bad ones). 3. User action → tool → confirmation (customer picks a slot; calendar is updated; reminder is scheduled).
The stack
- Ingress: signed webhooks, WhatsApp Cloud API, Meta/Google/Zillow lead forms, in-app SDKs.
- Orchestration: self-hosted n8n running on a dedicated VPC. Every workflow versioned in Git.
- AI: AI Gateway routing to Gemini 3 Flash by default, with model overrides per workflow.
- State: Postgres for durable state, Redis for cursors and rate-limit counters, S3 for artifacts.
- Observability: every step emits a structured log line + OpenTelemetry trace, replayable end-to-end.
Data flow
source → ingress (verify) → normalize → agent/tool call → side-effect → log → notify
Every hop is idempotent. Every side-effect is retryable. Every trace has a request-id that shows up in logs, notifications, and the ops dashboard.
Related