Back to How it Works Index
Technical Deep-Dive

Campaign Builder & CSV Pipeline Flow

Understand the core mechanics, queues, and logic routines running on our servers when processing this module.

System Execution Pipeline

Below is the step-by-step sequence of events executed by our background workers.

1

Upload Contacts

User uploads a CSV list. Papaparse processes headers and matches columns.

2

Sanity Checks

Filters duplicates and matches formatting to RFC 5322 guidelines.

3

MX Resolution

Queries DNS servers to verify recipient domains have active mail exchange servers.

4

Spintax & Merge

For each recipient, variables are replaced and a random Spintax variant is generated.

5

Queue Injection

Cleaned recipient entries are sent to the sharded queue.

Developer & Architect Notes

Technical Architecture

This module operates as a stateless service hosted across horizontally scalable server nodes. Distributed state coordinates through highly optimized Redis transactions to ensure consistency without deadlocks.

CSV ParserPapaparse Pipeline
DNS Checkingdns.resolveMx Resolution

Edge Fail-Safe Rules

Critical protocols (like connection failure retries, cool-down timers, and data limits) are verified before outbound dispatches. Failures degrade gracefully, prioritizing list health and preventing blacklisting.

CDN StorageCloudflare R2 Bucket
Content EvaluationRuntime Spintax Compilation Engine