Tercela

Open-source omnichannel platform for customer communication

Connect channels like WhatsApp, manage conversations in real time, and organize contacts — all in a unified interface.

Features · Quick Start · API Docs · Contributing · Roadmap

Features

Messaging

• Omnichannel inbox — Manage all conversations from a single dashboard
• WhatsApp integration — Send and receive messages via WhatsApp Cloud API
• Real-time updates — WebSocket-powered live messaging
• Message templates — Create, edit and sync WhatsApp message templates with Meta
• Media support — S3-compatible storage for images, audio, video and documents

Management

• Contact management — Centralized contact database with metadata
• Agent assignment — Route conversations to team members
• Channel adapter pattern — Extensible architecture to add new channels

Developer Experience

• REST API with OpenAPI docs — Interactive API reference via Scalar
• Automatic migrations — Versioned database migrations applied on boot
• Docker-ready — One command to run the entire stack
• Monorepo — Clean separation of API, frontend and shared packages

Tech Stack

Quick Start

With Docker (fastest)

git clone https://github.com/tags-dev/tercela.git
cd tercela
cp .env.example .env
docker compose up -d

Without Docker

git clone https://github.com/tags-dev/tercela.git
cd tercela
bun install
cp .env.example .env    # edit with your DATABASE_URL and JWT_SECRET
bun run dev

Open http://localhost:3000 — API docs at http://localhost:3333/reference.

Default login: [email protected] / admin123 — change immediately in production.

Scripts

API Reference

With the server running, open http://localhost:3333/reference for the interactive API documentation powered by Scalar.

Project Structure

tercela/
├── apps/
│   ├── api/            # Hono + Bun REST API (port 3333)
│   │   ├── src/
│   │   │   ├── routes/       # API endpoints
│   │   │   ├── services/     # Business logic
│   │   │   ├── channels/     # Channel adapters (WhatsApp, ...)
│   │   │   ├── db/           # Drizzle schema & migrations
│   │   │   ├── middleware/    # Auth & error handling
│   │   │   └── ws/           # WebSocket handlers
│   │   └── Dockerfile
│   └── web/            # Nuxt 4 frontend (port 3000)
│       ├── app/
│       │   ├── pages/        # Application routes
│       │   ├── components/   # Vue components
│       │   └── layouts/      # Layout wrappers
│       └── Dockerfile
├── packages/
│   └── shared/         # Shared types, constants & utilities
├── docker-compose.yml
├── .env.example
└── package.json

Roadmap

• AI / Chatbot support
• Multi-language dashboard
• Webchat widget (embed on any website)
• Analytics dashboard
• Email channel

Have an idea? Open a feature request.

Contributing

Contributions are welcome! Check out the Contributing Guide to get started.

Whether it's a bug fix, new feature, or documentation improvement — every contribution matters.

License

This project is licensed under the GNU Affero General Public License v3.0. See NOTICE for attribution details.