Documentation
Self-host CRM for WhatsApp Business end to end
From a fresh fork to a production deploy. Work through the six steps in order, or jump to the feature you need.
Start here
- 1Getting startedFork the wacrm repo, install dependencies, create the environment file and encryption key, and run the open-source WhatsApp CRM locally in about 15 minutes.
- 2Supabase setupCreate the Supabase project behind wacrm: grab the API keys, run the migrations, verify the schema and set up auth for the open-source WhatsApp CRM.
- 3WhatsApp setupConnect wacrm to the official WhatsApp Business API: create the Meta app, collect the IDs and token, configure the webhook and verify signatures.
- 4Environment variablesEvery environment variable wacrm reads, split into required, recommended and optional, with a sample .env.local file and a security checklist.
- 5Deploy on HostingerDeploy the wacrm WhatsApp CRM on Hostinger Managed Node.js Hosting: connect your GitHub fork, set environment variables, update the webhook and schedule cron.
- 6Automations cronSchedule the cron job that drains the wacrm automations queue, so Wait steps resume on time, using hPanel cron on Hostinger or an external pinger.
Features
- InboxShared workspace for WhatsApp conversations — real-time threads, templates, reactions, quote-replies.
- ContactsAddress book — manual add, CSV import, tags, contact detail view, deletion behaviour.
- PipelinesKanban deal boards with drag-drop stages, multi-pipeline support, and win-rate analytics.
- TemplatesBuild, submit, edit, and delete WhatsApp message templates in-app — with real-time approval status from Meta.
- BroadcastsBulk-send approved templates to a targeted audience. 4-step wizard, per-recipient delivery tracking.
- AutomationsEvent-driven step chains — keyword auto-replies, lead routing, tag-based reactions, webhook fan-out.
- FlowsBranching, button-driven WhatsApp conversations — no-code chatbots with handoff.
- AI AssistantBring-your-own-key AI for wacrm: one-click drafted replies, an optional auto-reply bot with human handoff, and a knowledge base built from your own docs.
- SettingsProfile + password, WhatsApp connection, tag library, default deal currency, color theme picker.
- MembersInvite teammates, role-based access, ownership transfer — turn a solo CRM into a shared team workspace.
Reference
- Public APIDrive wacrm from your own scripts: scoped API keys, REST endpoints for messages/contacts/conversations/broadcasts, and outbound event webhooks.
- ArchitectureHow wacrm is built: the Next.js and Supabase stack, the folder layout, how inbound and outbound WhatsApp messages flow, and the security primitives.
- TroubleshootingFixes for common wacrm problems: build errors, auth emails and reset links, Supabase permission errors, and WhatsApp webhooks that fail or stay silent.