Architecture & Integration Specifications

Architectural Decisions &
Salesforce CRM Integration.

Comprehensive documentation of Flowmeet's inbound demand conversion pipeline, RFC 5545 calendar handoffs, and enterprise CRM sync architecture modeled after Chili Piper Form Concierge & Distro.

ADR-001 • CORE ENGINE

How Meetings Are Created: RFC 5545 iCalendar Transport

When a prospect selects a time slot in Flowmeet, the system bypasses external calendar redirects and generates an RFC 5545 compliant .ics MIME object sent directly via Resend email transport.

RFC 5545 VEVENT PAYLOAD SPECIFICATIONMETHOD: REQUEST
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Flowmeet Inc//Inbound Discovery//EN
CALSCALE:GREGORIAN
METHOD:REQUEST
BEGIN:VEVENT
UID:flowmeet-1793551076@yusufsaka.dev
DTSTAMP:20261101T170000Z
DTSTART:20261102T150000Z
DTEND:20261102T153000Z
SUMMARY:Flowmeet Discovery • Stripe & Yusuf Abubakar
LOCATION:https://meet.google.com/flw-meet-live
ORGANIZER;CN="Yusuf Abubakar":mailto:yusuf@yusufsaka.dev
ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=NEEDS-ACTION:mailto:vp@stripe.com
STATUS:CONFIRMED
END:VEVENT
END:VCALENDAR
Why This Eliminates Dropoff:

When Gmail, Apple Mail, or Outlook receives an email with METHOD:REQUEST, the email client renders interactive “Yes / Maybe / No” buttons directly at the top of the message and automatically places the meeting on both parties' calendars without requiring any manual clicks or calendar logins.

ADR-002 • CRM DATA MODEL

Salesforce CRM Architecture & Lead-to-Account (L2A) Matching

Salesforce is the single source of truth for enterprise RevOps teams. Flowmeet implements standard and custom object synchronization, adhering to Chili Piper's data model specifications:

1. Account Object (001...)Target Match

Queries domain via SOQL (Website LIKE '%domain%'). If an existing enterprise account exists, Flowmeet extracts the Account.OwnerId to preserve account ownership.

2. Lead Object (00Q...)New Prospect

If no Account matches, a new Lead is created with Rating: 'Hot', LeadSource: 'Flowmeet Concierge', and custom fields (ICP_Score__c).

3. Event Object (00U...)Calendar Activity

Immediately logs the confirmed meeting under WhoId: Lead.Id and WhatId: Account.Id with Google Meet URL and assigned Sales Rep.

4. Opportunity (006...)Pipeline Tracking

Pre-populates deal stage to “Stage 1 - Discovery Scheduled” with estimated ARR computed from detected employee tier.

ADR-003 • ARCHITECTURAL COMPARISON: CHILI PIPER ALTERNATIVE

Self-Hosted Alternative to Chili Piper

Flowmeet provides an open, self-hostable alternative to commercial inbound conversion software. Here is how Flowmeet's modular microservices map to the capabilities of Chili Piper:

Form Concierge Equivalent

Interception of website form submissions, live domain qualification, and instant calendar presentation without page refresh.

Flowmeet Rust Scraper + SSE Stream
Distro Routing Equivalent

Lead qualification, territory scoring, and deterministic rep assignment in microseconds based on rules and region.

Flowmeet Go Concierge (:8082)
Instant Booker / Handoff Equivalent

Cal.com API integration, in-session slot picker, and RFC 5545 calendar invitation dispatch via Resend.

Flowmeet /api/book-slot + Resend
ADR-004 • RUST SCRAPER, FIRECRAWL & TF-IDF SEARCH

Rust Axum Crawler, Firecrawl Fallback & TF-IDF Search

Flowmeet uses a two-tier scraping pipeline paired with local TF-IDF document retrieval for buyer inquiries:

In-House Rust Crawler (:8081)~19MB RAM • ~500ms

Built on Axum and reqwest with SSRF validation, exact regex word boundaries, and streaming HTML to Markdown conversion. Handles 90%+ of standard web homepages with zero headless browser overhead.

Firecrawl v1 API FallbackAdversarial Fallback

When a domain renders strictly via client-side JavaScript or blocks plain HTTP fetchers, Flowmeet falls back to Firecrawl's headless browser API. Results are cached in-memory for 24 hours to prevent credit waste.

ADR-005 • CLAY, HUBSPOT & GA4 ENGINE

Clay Waterfall Enrichment & Free CRM Orchestration

Flowmeet operates as a revenue orchestration nexus, connecting top-of-funnel inbound capture to enterprise CRMs, waterfall data providers, and marketing measurement pipelines:

Clay.com WaterfallPOST /api/integrations/clay

Outbound dispatch to Clay table webhooks when high-value accounts arrive, and inbound webhook receiving enriched signals (revenue, funding stage, LinkedIn, headcount) to update Supabase and CRM records.

HubSpot Free CRM APIREST v3

Auto-creates or updates contacts via /crm/v3/objects/contacts and creates inbound Deals at appointmentscheduled stage with zero monthly software cost.

GA4 Server MeasurementAdBlock Immune

Fires server-to-server conversion events (book_meeting with estimated ARR value) directly to Google Analytics 4, bypassing client-side ad-blockers and privacy shields.

ADR-006 • 12-NODE n8n POLYGLOT ORCHESTRATION (4 STAGE GROUPS)
Download 12-Node Workflow (.json)

12-Node Parallel Polyglot Fan-Out, 50% RAG Circuit Breaker & Safe-Mode Resend Dispatch

Rather than relying on slow, ungrounded LLM chains, Flowmeet's production 12-node n8n workflow (n8n/polyglot-revenue-orchestrator.json) is organised into 4 logical stage groups and 2 Resend dispatch branches. It executes deterministic microservices in parallel, logs audit state to Supabase, enforces an ARR + 50% RAG confidence circuit breaker, and protects demonstration domains with a Safe-Mode guard:

1. Parallel Fan-Out (Nodes 1, 2a, 2b)Rust + Python

Webhook trigger fans out concurrently to /api/scrape (Rust Axum DOM-to-Markdown + tech stack) and /api/ai-brain (Python FastAPI semantic vector RAG).

2. 22µs Territory Lock & Audit (Nodes 3–6)Go 1.22 + Supabase

Rust firmographics pipe into /api/route-lead (Go goroutines compute ICP score, deal ARR tier, and Cal.com slot), merge with RAG citations, and persist to Supabase via /api/ingest.

3. Circuit Breaker (Node 7)$65k ARR / 50% RAG

If Estimated ARR >= $65,000 OR RAG Confidence < 50%, the workflow halts autonomous outreach and routes to the Founder HITL escalation branch (8a → 9a).

4. Resend Branches & Safe-Mode (Nodes 8a–9b)ACCEPTED_BY_RESEND + Webhooks

Requests passing guardrails enter the autonomous Resend branch (8b → 9b). Showcase domains (stripe.com, linear.app) are redirected by a Safe-Mode guard to protect third-party addresses, returning ACCEPTED_BY_RESEND upon API acceptance while subsequent delivery events are tracked via /api/webhooks/resend.

LIVE 12-NODE n8n POLYGLOT ORCHESTRATOR & CIRCUIT BREAKER TESTER

POST /api/n8n-orchestrate

Execute the 12-node n8n orchestration graph (4 stage groups, 50% RAG threshold, and 2 Resend dispatch branches) live across Rust (:8081), Go (:8082), Python RAG (:8083), Supabase, and Resend:

Select Orchestration Scenario:

LIVE SALESFORCE REST API TESTER

POST /api/salesforce/sync

Test how Flowmeet executes real-time Lead-to-Account (L2A) SOQL queries, routes to existing Account Owners, and creates Salesforce Event objects:

Select Prospect Domain: