Case Study · Enterprise Automation

WhatsApp Commerce
Automation Platform

End-to-end Shopify integration, abandoned cart recovery pipelines, and AI-powered payment validation — deployed for BlockBag Colombia.

ClientBlockBag (Colombia)

IndustryE-Commerce · Retail

PlatformShopify + WhatsApp

DeploymentRailway · Cloudflare

Year2025 – 2026

View Architecture ↓ Business Impact →

02 · Business Challenge

The Operational Gap

BlockBag operated with a predominantly manual, WhatsApp-mediated sales process creating systemic revenue leakage at every conversion touchpoint — with no structured abandoned cart recovery and no programmatic data capture in Shopify.

Revenue Leakage

Manual order capture resulted in untracked sales and inventory discrepancies within Shopify, limiting downstream analytics.

Cart Abandonment

No automated recovery mechanism for customers who initiated checkout but did not complete payment — revenue permanently lost.

Operational Overhead

Human agents required at every stage of the sales funnel, creating throughput bottlenecks and inconsistent customer experiences.

Billing Complexity

Dual-cycle payment routing (Quincena 1 / Quincena 2) enforced manually, causing frequent reconciliation errors.

Data Fragmentation

Customer PII existed in WhatsApp threads rather than structured Shopify records, blocking CRM and reporting capabilities.

Payment Validation

Receipt screenshots reviewed manually by the account owner, creating latency and subjective error risk in payment confirmation.

03 · Solution Architecture

Engineered Automation Ecosystem

A distributed, event-driven platform composed of four tightly integrated layers — each independently scalable and designed as a replicable module for future client deployments.

Conversational Engine

Node.js · Baileys · Railway · Express

Real-time WhatsApp session management and stateful conversation orchestration. Handles measurement validation, Shopify product lookup, dynamic payment routing, and automated order creation — entirely within WhatsApp, zero human intervention required.

Commerce Integration Layer

Shopify REST Admin API · Custom App · HMAC-SHA256

Bidirectional high-throughput data pipeline between the conversational engine and Shopify. Enables real-time product catalog queries, COP price retrieval, and programmatic order registration with full webhook signature verification.

Recovery Orchestration Pipeline

Make.com EU1 · Shopify Webhooks · Bot REST API

Event-driven abandoned cart recovery pipeline. Shopify fires checkout.abandoned webhooks to Make.com scenarios that trigger re-engagement WhatsApp messages via the bot's authenticated API endpoint.

Edge AI Validation Layer

Cloudflare Workers · Anthropic Claude Vision API · Base64

Serverless proxy layer that routes customer payment receipt images to the Anthropic Claude Vision API for automated document classification. Eliminates manual payment confirmation overhead while operating with zero-infrastructure overhead at the edge.

03b · Conversational Flow

WhatsApp Order Journey

Complete autonomous customer journey from first contact to confirmed Shopify order — zero human touchpoints required.

01
Customer
Messages
First contact
via WhatsApp

Measurement
Capture

cm validation
via regex

03
Catalog
Display
blockbag.co
sent in chat

Product
Lookup

Shopify API
real-time price

05
Payment
Routing
Q1/Q2 cycle
auto-detected

Receipt
Validation

Claude Vision
AI classifies

07
Order
Created
Shopify API
automated POST

05 · Automation Modules

Modular Feature Architecture

Seven independently deployable modules, each decoupled from the core flow to enable client-specific customization without re-architecture.

Stateful Order Engine

Fully self-contained WhatsApp sales funnel: measurements → catalog → product search → add-on upsell → Shopify order creation. Zero human intervention required.

Bi-Cycle Payment Routing

Programmatic detection of the current billing cycle (days 1–15 vs. 16–31) with automatic injection of the correct payment destination into the customer conversation.

Abandoned Cart Recovery

Make.com scenario subscribed to Shopify's checkout.abandoned webhook. Triggers a re-engagement WhatsApp sequence to recover high-intent customers who did not complete payment.

AI Receipt Validation

Customers upload payment screenshots in WhatsApp. Cloudflare Worker proxy routes image to Anthropic Claude Vision API for automated classification — approved or re-requested.

Advisor Handoff Engine

EN_ASESOR state: bot suspends automated responses for 20 minutes per conversation thread on advisor request, notifies owner, then auto-reactivates after the window expires.

Owner Alerts & KPI Reports

Cron-scheduled daily operational reports delivered to business owners via WhatsApp. Selective alert logic: only confirmed orders, advisor requests, and personalization inquiries trigger notifications.

Catalog Coexistence

WhatsApp Business native catalog preserved alongside automated bot via Meta Business Suite coexistence — without API migration, eliminating approval delays while maintaining full catalog-in-chat UX.

04 · Technology Stack

Infrastructure & Tooling

Component	Technology	Role	Rationale
Runtime	Node.js 18 LTS	Bot server / API gateway	Non-blocking I/O for high-concurrency WhatsApp sessions
WA Bridge	Baileys	WhatsApp session mgmt.	Cost-efficient approach prior to Meta Cloud API approval
Hosting	Railway	Deployment & scaling	Zero-configuration CI/CD from GitHub with environment isolation
E-Commerce	Shopify REST API	Product & order data	Source of truth for catalog, COP pricing, and order records
Automation	Make.com (EU1)	Workflow orchestration	Low-latency event handling for abandoned cart recovery pipelines
Edge Compute	Cloudflare Workers	API proxy / CORS bridge	Zero-infrastructure overhead for serverless AI validation routing
CDN	Cloudflare Pages	Demo deployment	Global CDN with sub-100ms TTFB for static assets
AI Vision	Anthropic Claude Vision	Receipt classification	High-accuracy payment document classification at the edge
Version Control	GitHub	Source management	Continuous deployment integration with Railway via webhooks

06 · Data Protection

Security & Compliance Architecture

All sensitive data flows were engineered to minimize surface area, eliminate unnecessary persistence, and enforce access controls under strict client data protection agreements.

✓

PII Minimization

Customer name, address, city, and phone collected only at order creation and transmitted directly to Shopify. No PII persisted in bot memory beyond the active session window.

✓

Environment Variable Isolation

All credentials — Shopify tokens, API keys, owner numbers, webhook secrets — stored exclusively as Railway environment variables. Never hardcoded in source or committed to version control.

✓

Selective Owner Notifications

Alert system gated to high-signal events only (confirmed orders, asesor requests, personalization inquiries). Customer conversation content is never forwarded, preserving end-customer conversational privacy.

✓

Edge Proxy Isolation

Cloudflare Worker proxy ensures payment receipt images are never stored at the edge. Images transmitted transiently to the Anthropic API and not persisted in any intermediate layer.

✓

Least-Privilege API Scoping

Shopify API provisioned with minimum required scopes (read_orders, read_customers, read_checkouts) via a dedicated custom app — following the principle of least privilege.

✓

HMAC-SHA256 Webhook Verification

All inbound Shopify webhook payloads validated against HMAC-SHA256 signatures using the provisioned webhook secret, preventing spoofed event injection into the automation pipeline.

07 · Business Impact

Measurable Operational Returns

By eliminating manual touchpoints at each stage of the sales funnel, the platform enabled BlockBag to operate a high-throughput conversational commerce channel with zero incremental staffing cost.

Impact Area	Before	After	Delta
Order Registration	Manual (human entry)	Automatic via Shopify API	~100% effort reduction
Cart Recovery	None (zero re-engagement)	Automated Make.com pipeline	New revenue channel
Payment Routing	Manual cycle tracking	Programmatic bi-cycle logic	Zero reconciliation errors
Receipt Validation	Manual screenshot review	Claude Vision AI classification	Overhead eliminated
Owner Notifications	All messages forwarded	Selective high-signal events	Alert fatigue eliminated
Response Time	Minutes to hours (human)	<2 seconds (automated)	>99% latency reduction
Data Capture	Fragmented WhatsApp threads	Structured Shopify records	Full analytics unlocked

WhatsApp CommerceAutomation Platform