Enterprise WhatsApp Architecture
BrokerOS integrates directly with the official Meta WhatsApp Cloud API through the dedicated@brokeros/int-whatsapp package. Designed for high-volume brokerage operations, the system handles incoming buyer inquiries, broadcasts project launches, and synchronizes real-time conversation state directly with CRM lead records.
Operating on the official Cloud API guarantees:
- Verified Business Profile status with green badge verification.
- Direct delivery through Meta global infrastructure with no third-party intermediary latency.
- Full compliance with Meta business messaging policies and 24-hour customer service window guidelines.
- Support for interactive components including Quick Reply buttons, List Menus, CTA URLs, phone dialers, and media headers (PDF brochures, images, walkthrough videos).
Architecture and Execution Flow
Core WhatsApp Modules
Team Inbox
Unified multi-agent shared inbox for real-time customer conversations. Includes agent assignment, internal team notes, quick replies, and lead status syncing.
Contact Directory
Centralized WhatsApp contact management, CSV audience list import, custom field tracking, and 5-tab Lead 360 detail drawers.
Broadcast Campaigns
High-throughput messaging to segmented leads or imported CSV lists using Meta-approved utility and marketing templates with live read receipt tracking.
Tiers, Pricing & Pre-Flight
Meta messaging tiers (1K to Unlimited), phone quality score protection, conversation category pricing, and pre-flight capacity audits.
Interactive Messages
Build zero-typing Quick Reply buttons and multi-section List Menus validated against Meta API limits with real-time mobile preview.
Chatbot Flows
Visual no-code conversation builder for automated lead qualification, project brochure delivery, FAQs, and instant site visit booking.
Drip Automations
Multi-stage automated messaging sequences triggered by lead creation, stage transitions, or site visit follow-ups across structured day intervals.
Visual Pipelines
Kanban-style conversation management board mapping chats across qualification stages from initial discovery to contract signing.
Template Manager
Create, preview, submit, and track approval status for Meta templates across Marketing, Utility, and Authentication categories.
AI Assistant & Settings
Configure Groq language models (
openai/gpt-oss-120b), custom system prompts, HMAC-SHA256 webhook diagnostics, and CRM tags.Message Types and Service Windows
Meta enforces strict distinction between pre-approved template messages and free-form session messages:Every inbound message from a lead resets the 24-hour customer service window. During this window, sales agents can communicate freely without paying template conversation fees or requiring pre-approved copy. Once the window expires, outgoing communication must initiate via an approved template message.