📖About
Carol Message Handler is a droid that handles incoming WhatsApp and web messages for Carol. It prepares text and media attachments for processing and coordinates responses, from quick acknowledgments to substantive replies.
📖Usage
Readers encounter it when sending Carol text, voice messages, images, videos or documents through WhatsApp or web chat. It supports the estate’s conversation work by connecting incoming messages to Carol’s response process.
📖Purpose
message-handler is the bridge between raw inbound messages and Carol's response. It decodes media attachments, manages typing indicators, runs the reflex quick-response path for instant acknowledgments, and orchestrates the full LLM-driven reply path for substantive responses. It also powers the web-chat endpoint for Google OAuth authenticated users.
📖Duties
- Receive and decode WhatsApp messages (text, voice, image, video, document)
- Transcribe voice messages via speech-to-text
- Send typing indicators for human-like pacing
- Run reflex quick-reply for instant acknowledgments before full processing
- Orchestrate the full LLM-driven reply path for substantive messages
- Handle web-chat messages from Google OAuth users via the internal relay
📖Constraints
- Must handle all WhatsApp message types (text, voice, image, video, document)
- Voice processing depends on Gemini/OpenAI TTS availability
- Reflex replies must complete in <3s for acceptable user experience
- Full processing can take up to 120s with tool calls
👤Belongs to
Source: Droid Families · Public information reflected here.