Customs Clearance Brokers & Freight Forwarding Logistics Agencies

Bortselite Brokerage Bot — Customs Automation & Container Tracking

Customs brokers overwhelmed by hundreds of daily repetitive phone calls from cargo owners inquiring about container tracking, customs clearance stages, and port fee status.

.NET 9WhatsApp Cloud APITelegram APIDockerRailwaySerilogWebhooks
Bortselite Brokerage Bot — Customs Automation & Container Tracking

Operational Benchmarks

Measurable impact achieved in production.

80%

Manual Inquiries Reduced

< 1 ثانية

Response Latency

99.9%

Bot Availability

WhatsApp + Telegram

Supported Channels

Operational Challenges

Critical bottlenecks prior to system deployment

  • Live integration with maritime container tracking and port clearance APIs.
  • 24/7 automated instant responses across WhatsApp Cloud API and Telegram.
  • Automated push notifications on milestone events (Customs Cleared, Port Exit).
  • Deploying via lightweight, cost-effective Docker containers on cloud PaaS.

Operational Transformation

Direct before vs after production benchmarks

Customer Status Inquiry

BeforeNon-stop phone calls disrupting office work
Now24/7 instant automated query by container number

Clearance Notification

BeforeDelayed communication causing demurrage fees
NowInstant automated WhatsApp push upon clearance

Architectural Decisions & Trade-offs

Engineered design choices, technical rationale, and evaluated trade-offs

01

Built on .NET 9 Web API

Architectural Rationale:

Exceptional concurrent webhook throughput and minimal container memory consumption.

Calculated Trade-off:Requires dedicated container deployment compared to serverless scripts.
02

Multi-Channel Omni-Desk (WhatsApp + Telegram)

Architectural Rationale:

Offered seamless customer tracking via WhatsApp while providing an internal alert desk on Telegram.

Calculated Trade-off:Managing divergent platform rate limits and message format payloads.

Data Flow & Integration Pipeline

Live visual pipeline demonstrating real-time data exchange across services, AI engines, and databases.

B2C Web Portal
Global GDS APIs
WhatsApp Bot
Central Core API
Vector DB (RAG)
Background Tasks
Relational Database
Live Subsystems & Interfaces

Production Interfaces & Modules

Comprehensive architectural walkthrough of live dashboards, portals, and background engines.

Media Attachment Handling / CRM Webhooks
Supplier Identification & Commercial Invoice Ingestion
Inspect Full Resolution

Supplier Identification & Commercial Invoice Ingestion

Document & Invoice Ingestion

Step collecting manufacturer credentials and commercial invoices/quotations as media or text for clearance forwarding.

Defensive Validation / Context Recovery
Strict HS Code Regex Error Handling & Recovery Flow
Inspect Full Resolution

Strict HS Code Regex Error Handling & Recovery Flow

Error Handling & Recovery

Strict regex pattern validator intercepting malformed HS codes (4-10 digits required) with graceful conversational recovery.

Regex Input Validation / Conversational UX
Customs Tariff HS Code Validation & Input Prompt
Inspect Full Resolution

Customs Tariff HS Code Validation & Input Prompt

Customs Data Validation

Guided prompt validating HS tariff code input against international customs classifications.

WhatsApp Business Cloud API / Node.js
Ports Elite Logistics Interactive WhatsApp Main Menu
Inspect Full Resolution

Ports Elite Logistics Interactive WhatsApp Main Menu

WhatsApp Chatbot & Conversational AI

Interactive 8-service conversational menu for Saudi customs clearance, Saber certification, international freight, and warehousing.

Finite State Machine / Dialog State Tracking
Saber Conformity Certification Product Intake Flow
Inspect Full Resolution

Saber Conformity Certification Product Intake Flow

Automated Customer Intake

Conversational onboarding flow capturing imported product specifications for Saudi Saber conformity compliance.

Architectural Lessons Learned
"If rebuilt, I would connect the bot directly to billing gateways to generate and dispatch payment links for customs fees within the chat thread."

— Mahmoud Talaat, Founder & Lead Systems Architect