Data Flow

Customer Journey:
  Website Form → N8N Webhook (popn-contact)
       OR
  Phone Call → Vonage → AI Voice Agent (Cartesia)
       ↓
┌─────────────────────────────────────┐
│         N8N Workflow Engine         │
├─────────────────────────────────────┤
│ POPN-webform (contact form)        │
│ POPN-create-booking                │
│ POPN-get-slots                     │
│ POPN-cancel-booking                │
│ POPN-payment-link (Stripe)         │
│ POPN-stripe-event (payment conf.)  │
│ POPN-voice-events                  │
│ POPN-config (config server)        │
└─────────────────────────────────────┘
       ↓                    ↓
  Google Calendar      Config Server
  (per performer)    (.POPN-variables.json)
       ↓
  Admin Portal (this app)
  - Pricing management
  - Performer management
  - SMS templates
  - Integration config

Tech Stack

Face Painting OR Balloon Twisting

1 artist provides the service. Same pricing for either service.

Bubble Party

Includes bubble machines, wands & pools. Outdoor recommended.

Caricatures OR Glitter Tattoos

1 artist. ⚠️ Caricatures NOT available in Houston region.

Live Glitter Fashion Drawing

1 artist. Premium service — no 1.5hr or 2.5hr options.

Travel Fee

• Flat $25 within 80-mile radius
• Radius measured from HQ (14201 Coyote Trail, Haslet TX) or assigned contractor's base location
• Beyond radius: contact for custom quote

Payment Structure

• Deposit: 30% non-refundable (unless Poppin' cancels → full refund)
• Final Balance: Remaining 70% collected 3 days before event
• Method: Stripe Payment Links sent via SMS

End-to-End Booking Process

Two-Stage Stripe Payment Links

Stage 1: Deposit
  Customer confirms → N8N creates Stripe Payment Link (30%)
  → Vonage sends SMS with link
  → Customer pays
  → Stripe webhook fires checkout.session.completed
  → N8N triggers "Booked" confirmation + calendar event

Stage 2: Final Balance (3 days before event)
  Scheduled N8N trigger
  → Creates Stripe link for remaining 70%
  → Vonage sends SMS with link + artist info
  → Customer pays
  → Stripe webhook confirms → event fully paid

Setup

• Create Stripe account for Poppin' Parties TX
• Add publishable key + secret key in Integrations tab
• Set up webhook endpoint: https://n8n.optimus.systems/webhook/popn-stripe-event
• Subscribe to event: checkout.session.completed

Payment Link API

N8N workflow creates payment links dynamically via POST /v1/payment_links with amount, description, and metadata (booking ID, customer name).

Phone Number

Vonage number: +1 (972) 777-6725

Capabilities

• SMS: Send/receive text messages (payment links, confirmations, reviews)
• Voice: Inbound call routing to AI agent, outbound lead follow-up

Overview

Cartesia Line AI agent handles inbound and outbound calls with a fun, party-themed personality matching the Poppin' Parties brand.

Capabilities

• Inbound: Answer availability questions, quote prices, take booking details, check calendar
• Outbound: Follow up on website form submissions that haven't converted
• Pricing: Query config server for real-time quotes (up to 8hr events)
• Handoff: Transfer to KateLyn for complex requests

Overview

280 auto-generated city+service SEO landing pages across 3 regions. Generated by node generate-seo-pages.js. Do not hand-edit — they are overwritten by the generator.

Core Service Pages

Payment Status Colors

Calendar events automatically change color as payments are received:

How It Works

• New bookings are created with tangerine (unpaid)
• When Stripe fires checkout.session.completed, the POPN - Payment Received N8N workflow updates the event color and description
• Payment status is only visible to owners in the calendar description (artists see event details only)
• You can also manually record a payment via the webhook (see BOOKING-AUTOMATION-SYSTEM.md)

Core Integrations

Infrastructure

Getting Started

• Sign in with an authorized Google account (set in Admin Users tab)
• All changes auto-save after a 1.5s delay or when clicking Save
• The ⚡ indicator shows unsaved changes

Tabs Reference

Config Server API

Quote API Example

GET /pricing/quote?services=face-painting,balloon-twisting&duration=2&city=Dallas

Response:
{
  "services": "Face Painting + Balloon Twisting",
  "duration": 2, "basePrice": 350,
  "travelFee": 25, "totalPrice": 375,
  "depositPercent": 30, "depositAmount": 113,
  "balanceAmount": 262, "artistsRequired": 2
}