# Deploy wacrm with Easypanel

URL: /templates/wacrm

wacrm is an open-source, self-hosted CRM built on the official WhatsApp Business API. It gives a team a shared inbox for one WhatsApp number, contacts with tags and custom fields, Kanban sales pipelines linked to conversations, Meta-approved broadcast campaigns, and a no-code automation builder. A bring-your-own-key AI assistant can draft replies or answer from a knowledge base, and a public REST API plus an MCP server let you build on top of it. All data lives in your own Supabase project, so there is no per-seat fee and no vendor lock-in.

## Installation notes

Before the app will start, you need a Supabase project (hosted on
supabase.com, or self-hosted) with this repo's `supabase/` migrations
applied via the Supabase CLI, plus a Meta for Developers app with the
WhatsApp Business API enabled. Fill in the Supabase and Meta fields below
with those values, then deploy. After the first deploy, open the app,
create your account, and connect your WhatsApp number from Settings.
Generate `ENCRYPTION_KEY` once and never rotate it casually — rotating it
orphans every WhatsApp token encrypted under the previous key, requiring
everyone to reconnect.


## Benefits

### Own your data

Everything lives in your own Supabase project on your own domain — no SaaS lock-in and no per-seat pricing.

### Official WhatsApp Business API

Built on Meta's Cloud API, not an unofficial bridge, so it stays compliant and reliable.

### Bring-your-own AI

Paste your own OpenAI or Anthropic key for AI-drafted replies and knowledge-base answers; no shared AI fee.

## Features

### Shared team inbox

Multiple agents work one WhatsApp number with per-conversation assignment, status, and notes.

### Contacts and pipelines

Contacts with tags and custom fields, CSV import, and Kanban sales pipelines linked to conversations.

### Broadcasts and automations

Meta-approved broadcast templates with delivery tracking, and a visual no-code automation builder for triggers, waits, and webhooks.

### Public API and MCP server

Scoped, revocable API keys for the public REST API, plus an MCP server to drive the CRM from Claude, Cursor, and other AI assistants.

## Configuration

- `appServiceName` (App Service Name, required): wacrm

- `supabaseUrl` (Supabase Project URL, required): Set during installation — Project Settings → API → Project URL, e.g. https://xxxx.supabase.co

- `supabaseAnonKey` (Supabase Anon Key, required): Set during installation — Project Settings → API → anon public key

- `supabaseServiceRoleKey` (Supabase Service Role Key, required): Set during installation — Project Settings → API → service_role key. Bypasses RLS; kept server-side only.

- `metaAppSecret` (Meta App Secret, required): Set during installation — Meta for Developers → App Settings → Basic → App Secret

- `metaAppId` (Meta App ID (optional)): Set during installation — Required only to submit WhatsApp message templates with an image header.

- `appLocale` (UI Language): English / Korean / Brazilian Portuguese / Spanish

## Services

- wacrm: app

## Resources

- [Website](https://wacrm.tech)

- [GitHub](https://github.com/ArnasDon/wacrm)

- [Documentation](https://wacrm.tech/docs)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/wacrm)