Conversation Layer

This module contains the services that handle messaging for WhatsApp and the web chat interface. All source code is now written in TypeScript. It is composed of three containers:

• openwa – provides access to WhatsApp through the open-wa project.
• whatsapp-router – receives webhook events from openwa and forwards messages to a conversation handler. Handlers can be configured per chat ID in whatsapp-router/src/chatHandlers.ts.
• chat-ui – simple web chat interface that also communicates with the LLM agent.

All services can be launched together with docker-compose.

Usage

1. Configure the URL of your LLM agent in docker-compose.yml (LLM_AGENT_URL).
2. Optionally edit whatsapp-router/src/chatHandlers.ts to map specific chat IDs to different handler URLs.
3. Run:

docker-compose up --build

The chat UI will be available on http://localhost:3000. Open-wa exposes its API on port 8080 and the WhatsApp router listens on port 3001.