Skip to content

Motion is a WhatsApp Assistant that lets users book rides, order food, send parcels, and buy groceries—all through one simple chat.

Notifications You must be signed in to change notification settings

khaymanii/Motion-BE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Motion - Simplifying Everyday Movement

Motion is a WhatsApp Assistant that lets users book rides, order food, send parcels, and buy groceries—all through one simple chat. Instead of juggling multiple apps, users simply chat, choose, and confirm.

Screenshot 2026-01-20 092329

🚀 Why Motion?

Most on-demand service platforms struggle with:

  • App fatigue (too many apps for simple tasks)
  • High mobile data usage
  • Poor onboarding and drop-offs
  • Low repeat engagement

Motion solves this by turning WhatsApp into a super app.

Key Benefits

  • Zero app install required
  • Works on any smartphone
  • Fast, chat-based UX
  • High engagement and completion rates
  • Reduced mobile engineering cost
  • Easy expansion into new services

🧠 Core Features

  • WhatsApp Cloud API integration
  • Menu-driven + natural language interaction
  • Ride booking flow
  • Food ordering flow
  • Parcel delivery flow
  • Grocery shopping flow
  • Conversation state management
  • Idempotent message handling
  • Stateless backend design

🏗️ System Architecture

User (WhatsApp)

WhatsApp Cloud API

AWS API Gateway

AWS Lambda (Node.js)

├── Flow Engine (Conversation State)
├── DynamoDB (Session & Order Data)
├── Validation & Idempotency Layer
├── Service Logic
│ ├── Ride Booking
│ ├── Food Ordering
│ ├── Parcel Delivery
│ └── Grocery Shopping


WhatsApp Message Response


⚙️ Infrastructure Breakdown

API & Compute

  • AWS API Gateway – WhatsApp webhook entry
  • AWS Lambda (Node.js) – Stateless request processing

Data Layer

  • Amazon DynamoDB
    • User session state
    • Active conversation flow
    • Order metadata
    • Message idempotency
    • TTL-based session cleanup

CI/CD Pipeline

  • GitHub – Source control
  • Jenkins – Pipeline orchestration
  • Docker – Build & packaging
  • Docker Hub – Image storage
  • AWS Lambda – Deployment target

Observability

  • Amazon CloudWatch
    • Logs
    • Metrics
    • Error monitoring

Security

  • AWS IAM
    • Least-privilege access
  • Environment variables for secrets
  • No hardcoded credentials
  • Secure webhook validation

🔁 CI/CD Deployment Flow

GitHub Push

CI Pipeline (Jenkins / AWS CodePipeline)

Install Dependencies & Run Tests

Package Lambda Artifact (ZIP or Container Image)

Upload Artifact (Amazon S3 / Amazon ECR)

Update AWS Lambda Function Code

Publish New Lambda Version

🚀 Live WhatsApp Bot

Deployments are automated, repeatable, and rollback-safe.


📈 Scaling Strategy

  • Serverless-first architecture
  • Auto-scales with incoming messages
  • DynamoDB on-demand capacity
  • No server management
  • Handles traffic spikes naturally

🧯 Reliability & Recovery

  • Stateless Lambda execution
  • DynamoDB TTL cleanup
  • Idempotent webhook handling
  • Fast redeployment via CI/CD
  • No single point of failure

📊 Observability & Debugging

Motion is observable by default:

  • Lambda execution logs
  • Webhook latency tracking
  • Error and retry visibility
  • Service-level metrics

This enables fast debugging and stable production behavior.


📚 Case Study Summary

Problem

Users rely on multiple apps for everyday services, leading to friction and low engagement.

Solution

Consolidate essential services into a single WhatsApp-based AI assistant.

Challenges

  • Managing multi-step conversational flows
  • Preventing duplicate webhook processing
  • Maintaining state in a stateless system

Solutions

  • Flow-driven conversation engine
  • DynamoDB-backed session storage
  • Idempotent message handling
  • Clear menu-based UX

Learnings

  • Chat-based UX increases completion rates
  • Stateless systems scale effortlessly
  • WhatsApp is a powerful distribution channel

🔮 Future Improvements

  • AI-powered free-text intent detection
  • Payment integrations
  • User preference learning
  • Location-aware recommendations
  • Admin dashboard for service providers
  • Multi-language support

👨‍💻 Author

Kenneth Akpo
Frontend & Cloud Engineer

  • Builds serverless, DevOps, and conversational platforms
  • Focused on scalable, real-world products
  • Open to collaboration and leadership roles

🔗 Let’s build the future of everyday services.


📜 License

MIT License

About

Motion is a WhatsApp Assistant that lets users book rides, order food, send parcels, and buy groceries—all through one simple chat.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published