Skip to main content

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 drop-in WhatsApp Cloud Platform engine for Django. Install it, mount the URLs, add your Meta credentials, and you immediately get a real-time chat inbox, bulk marketing campaigns, contact management, webhook processing, and a REST API — all running inside your existing Django project with no third-party SaaS subscriptions required.

Quickstart

Install the package and send your first WhatsApp message in under 5 minutes.

Configuration

Explore every setting in the WHATSAPP config dict and optional environment variables.

REST API

Authenticate and call the HTTP endpoints to send messages and manage campaigns programmatically.

Python API

Use the low-level utility functions to send messages, sync templates, and run campaigns from your own code.

What’s included

django-meta-whatsapp provides a complete WhatsApp business platform that integrates directly into Django. Every feature is built on the Meta WhatsApp Cloud API v22.0.

Live Inbox

Real-time chat interface with media, reply threading, and message status ticks.

Contact Management

Import CSVs, assign colored labels, filter, and export your contact database.

Message Templates

Sync approved templates from Meta, create new ones, and push updates back.

Marketing Campaigns

Schedule and send bulk template messages with delivery, read, and bounce analytics.

In-App Signups

Create shareable wa.me deep links so users can opt-in to your messaging list.

Webhooks Engine

Auto-ingest inbound messages, delivery receipts, and status updates from Meta.

Multi-Account

Host multiple WhatsApp Business Accounts in a single Django project.

Catalog & Products

Sync your Meta Commerce catalog and send interactive product messages.

Get started in 4 steps

1

Install

pip install django-meta-whatsapp
2

Configure

Add django_meta_whatsapp to INSTALLED_APPS, mount the URLs, and add your WHATSAPP settings dict with your Meta API token, phone number ID, and webhook verify token.
3

Migrate

python manage.py migrate
4

Open the dashboard

Visit /whatsapp/ in your browser. Connect your WhatsApp account, set your Meta App webhook URL to https://yourdomain.com/whatsapp/webhook/, and start chatting.
django-meta-whatsapp requires Django 4.0+ and Python 3.9+. It depends only on Django and requests — no additional services are needed unless you opt in to Celery for async campaigns.

Build docs developers (and LLMs) love