Skip to main content
AmbioSys Hero Light

​
Welcome to AmbioSys

AmbioSys is a comprehensive business process management system designed specifically for Ambiotec S.A., providing end-to-end management of customer relationships, service requests, quotations, and financial operations with integrated AI-powered communication.

Customer Management

Track customers, contacts, and locations with geographic integration and department-based organization.

Service Requests

Manage service requests with SLA policies, automatic deadline tracking, and multi-vendor assignments.

Quotations & Sales

Create quotations, track follow-ups, and manage the complete sales lifecycle with automated reminders.

AI WhatsApp Bot

GPT-4 powered WhatsApp bot for customer support with real-time Socket.IO integration.

​
Core Capabilities

  • Complete customer profiles with document types and tax IDs
  • Multiple contacts per customer with role assignments
  • Geographic location tracking with departments and municipalities
  • License management with expiration tracking
  • Customer zones and sales territory management
  • Multi-status workflow (unconfirmed → confirmed → in progress → completed)
  • SLA policy enforcement with automatic deadline calculations
  • Vendor assignments with notification groups
  • Post-rejection follow-up tracking
  • Requested delivery date monitoring
  • Real-time status updates via dashboard
  • Product catalog with pricing
  • Sales line tracking
  • Quotation templates with document generation
  • Status workflow (draft → sent → accepted → rejected → finalized)
  • Automated follow-up reminders via cron jobs
  • Public quotation acceptance links
  • Credit application processing
  • Payment tracking and history
  • Credit limit management
  • Integration with quotations for financial approval
  • WhatsApp webhook integration (Meta Business API)
  • GPT-4 powered conversational responses
  • Real-time message handling with Socket.IO
  • Chat history and context management with Redis
  • Both external (customer) and internal chat support
  • Real-time dashboard with key metrics
  • SLA monitoring views
  • Overdue follow-up tracking
  • Unconfirmed requests overview
  • API usage logging
  • System event logs

​
Technology Stack

Backend API

Express.js with Node.js 20
  • RESTful API architecture
  • JWT authentication
  • Session management with Redis
  • Swagger API documentation

WhatsApp Bot

Express.js + OpenAI
  • GPT-4 integration
  • Socket.IO real-time events
  • Webhook handling
  • Redis for chat context

Frontend

React + Vite
  • Material-UI components
  • React Router v6
  • Context-based state management
  • PWA support with offline mode

Database

PostgreSQL
  • Schema: db_ambiotec
  • Stored procedures for business logic
  • Views for SLA monitoring
  • Full ACID compliance

Cache & Queue

Redis
  • Session storage
  • BullMQ job queues
  • Chat context caching
  • Rate limiting

Orchestration

Docker Compose
  • Multi-container setup
  • Hot-reload for development
  • Network isolation
  • Volume persistence

​
Key Integrations

1

WhatsApp Business API

Meta’s official API for receiving and sending WhatsApp messages with webhook verification.
2

OpenAI GPT-4

Natural language processing for intelligent customer support responses.
3

AWS S3

File storage with presigned URLs for document uploads and attachments.
4

Google APIs

Authentication and calendar integration for scheduling.
5

Nodemailer

Email notifications for quotations, reminders, and system alerts.
6

Puppeteer

PDF generation for quotations and reports.

​
Architecture Highlights

AmbioSys follows a microservices architecture with separation of concerns:
  • Backend API (ambiotec-backend on port 3000) handles business logic and data
  • WhatsApp Bot (gpt4-ambiotec-bot on port 4500) manages AI conversations
  • Frontend (Vite dev server on port 5173) provides the user interface
  • Redis (port 6379) enables inter-service communication and caching

​
Getting Started

Quick Start

Get AmbioSys running locally in under 5 minutes with Docker Compose.

Architecture Overview

Understand the microservices structure and how components interact.

API Reference

Explore the REST API endpoints with interactive Swagger documentation.

Database Schema

Learn about the database structure and tables.

​
Who Uses AmbioSys?

AmbioSys is used by Ambiotec S.A. teams including:
  • Sales Teams - Manage quotations, follow-ups, and customer communications
  • Service Coordinators - Track service requests and vendor assignments
  • Customer Support - Handle incidents and WhatsApp conversations
  • Finance Department - Process credits and payments
  • Administrators - Configure roles, permissions, SLA policies, and notification groups
Ready to dive in? Start with the Quick Start Guide to get your local environment set up.

Build docs developers (and LLMs) love

Get started for freeTalk to us