Documentation Index
Fetch the complete documentation index at: https://mintlify.com/rahul-baberwal/django-meta-whatsapp/llms.txt
Use this file to discover all available pages before exploring further.
django-meta-whatsapp is a production-ready, drop-in Django library that wraps the Meta WhatsApp Cloud API v22.0 and delivers a full-featured CRM and messaging platform directly inside your existing Django project. Rather than routing data through a third-party SaaS, everything — the inbox, campaign engine, webhook receiver, template sync, and REST API layer — runs in your own infrastructure. It ships with a beautiful Tailwind UI, supports multiple WhatsApp Business Accounts from a single Django project, and works with or without Celery for async campaign dispatch.
Quickstart
Install the package and send your first WhatsApp message in under 5 minutes.
Configuration
Full reference for the
WHATSAPP settings dict — credentials, UI, audiences, and more.Core Features
Explore the live unified inbox, reply threading, and media support.
API Reference
REST API endpoints, authentication, and cURL examples.
Key Features
Live Unified Inbox
Real-time chat interface with media support, reply threading, and delivery status ticks. All conversations in one place.
Marketing Campaigns
Schedule and send bulk messages using approved WhatsApp Templates. Track delivery, read rates, and bounce rates.
Contact Management
Import contacts via CSV, assign dynamic colored labels, and auto-sync users who subscribe via WhatsApp deep-links.
Message Templates
Sync approved templates from Meta with one click, or create and push new ones directly from the dashboard.
In-App Signups
Create and manage
wa.me deep-links so users can instantly opt in to your WhatsApp channel.Webhook Engine
Built-in webhook endpoint automatically ingests incoming messages, delivery receipts, and status updates from Meta.
Multi-Account Support
Run one Django project with multiple WhatsApp Business Accounts. Switch the global account from the dashboard.
REST API
Send text, location, and templates; list chats and campaigns — all behind API-key authentication.
Requirements
| Requirement | Minimum Version |
|---|---|
| Python | 3.9+ |
| Django | 4.0, 5.0, or 5.1 |
requests | 2.28+ |
Django and requests. Celery (celery>=5.0 and django-celery-beat>=2.0) is an optional extra for async campaign execution and is never required for the core feature set.
django-meta-whatsapp is released under the MIT License and is free to use in personal and commercial projects. See the LICENSE file for details.