WhatsApp AI Agents - Cerebral Valley Meta Hackathon 2025

This repository contains AI agents built on the CM.com platform for the Cerebral Valley Meta WhatsApp Hackathon.

See https://cerebralvalley.ai/e/whatsapp-hack.

Overview

Our project showcases a multi-agent system that provides automated customer support for Mobile Network Operators (MNOs) through WhatsApp Business API. The system uses a root agent to intelligently route user requests to specialized agents, each handling specific support tasks.

AI Agents

Our implementation features 5 specialized agents:

• Root Agent: Receives the initial input and decides which agent should handle the request
• PUK Request Agent: Helps the user to retrieve their PUK code
• Phone Settings Agent: Helps the user to change calling settings for their subscription
• FAQ Agent: Helps the user to answer generic questions about their subscription
• Usage Check Agent: Helps the user to check their usage and suggests ways to improve their usage

Detailed documentation and code for each agent can be found in the agents/ folder.

Key Features

• Multilingual Support: All agents support multiple languages with persistent language preferences
• Intelligent Routing: Root agent determines the best specialized agent for each request
• Seamless Handoffs: Agents can transfer back to the root agent or escalate to human support
• Tool Integration: Agents use specialized tools for PUK retrieval, settings management, usage monitoring, and RAG-based FAQ

Technology Stack

• Platform: CM.com
• Messaging Channel: WhatsApp Business API
• Architecture: Multi-agent system with specialized task routing

Project Structure

whatsapp-hackathon-2025/
├── agents/                    # AI agent implementations
│   ├── Root Agent.md         # Main routing agent
│   ├── PUK Request Agent.md  # PUK code retrieval
│   ├── Phone Settings Agent.md # Subscription settings management
│   ├── FAQ Agent.md          # RAG-based FAQ answering
│   ├── Usage Check Agent.md  # Data usage monitoring
│   └── README.md             # Agent documentation
└── README.md                 # This file

Team

Built for the Cerebral Valley Meta WhatsApp Hackathon 2025

License

This project is licensed under the MIT License - see the LICENSE file for details.

This software is provided "as-is" without any warranty or guarantee of reliability.