Frappe WhatsApp

Seamless WhatsApp integration for Frappe using Meta's official API — no third-party services required.

WhatsApp Demo

Bulk Message Feature Guide

Important Note

If you're not using live credentials, follow step no 2 to add the test number on Meta to which you're sending messages.

Chat Application

You can also install whatsapp_chat along with this app to send and receive messages like a messenger.

Installation

Step 1: Get the App

bench get-app https://github.com/shridarpatil/frappe_whatsapp

Step 2: Install on Your Site

bench --site [sitename] install-app frappe_whatsapp

Setting Up WhatsApp Notifications

1. Get Your WhatsApp Cloud API Credentials

Get your WhatsApp Cloud API credentials here

2. Enter WhatsApp Credentials in Frappe

3. Create a Template

Supports all Doc Events

4. Create Notifications

Sending Text Messages

Sending Without a Template

• Create an entry in the WhatsApp Message doctype
• On save, it triggers the WhatsApp API to send the message

Receiving Messages via WhatsApp Cloud API

Advanced Usage: Custom _dict() Template

Sending a Template Without a Doctype

Useful when you can't pull values directly from a doctype. Define a script and populate the variable _data_list:

doc.set("_data_list", data_list)

Example:

Setting Up Incoming Messages

1. Set up a webhook on Meta
2. Add a verify token on Meta and update the same in WhatsApp Settings
3. Add the webhook URL on Meta:

   <your-domain>/api/method/frappe_whatsapp.utils.webhook.webhook
   

4. Add appropriate webhook fields:
   • messages to receive messages
   • Add other required webhook fields

Upcoming Features

• Update templates directly on Facebook Developer Console
• Display template status inside Frappe

---

License

MIT License — Free to use and modify.