WhatsApp integration allows you to send and receive WhatsApp messages from within the lead and deal pages in Frappe CRM. This streamlines communication and keeps all interaction history centralised for better customer relationship management.


A dedicated WhatsApp tab is available on both Lead and Deal pages, providing a real-time chat window for efficient communication.

  • Lead: The mobile number field of a Lead is used to initiate and receive WhatsApp messages.

  • Deal: The primary contact number associated with a Deal is used for WhatsApp communication.


WhatsApp integration requires a separate app called "Frappe WhatsApp" developed by Shridhar.

Configuration Steps

To enable WhatsApp integration in Frappe CRM, follow these steps:

  1. Obtain WhatsApp Business Credentials: Refer to the official WhatsApp guide for creating a WhatsApp Business account and acquiring the necessary credentials WhatsApp Business Account Creation Guide.

  2. Configure WhatsApp Settings:

    • Click the dropdown menu on the top left logo and select "Settings."

    • Locate the WhatsApp Settings.

    • Enter the credentials obtained in step 1.

    • Enable the WhatsApp integration.

  3. Set up the Webhook:

    A webhook URL is required to establish communication between Frappe CRM and WhatsApp Business. Use the following URL format, replacing <yoursitename> with your actual Frappe CRM site name and including the Webhook Verify Token you created in the WhatsApp Settings in Verify token field


Creating WhatsApp Templates

To ensure compliance and streamline communication, Frappe CRM utilizes WhatsApp templates. These pre-approved messages can be created and managed within the system.

  1. Navigate to the WhatsApp Templates DocType.

  2. Click on Add WhatsApp Template.

  3. Fill in the required details for your template message.

  4. Save the template.

With these configurations in place, you're ready to leverage WhatsApp Business for efficient communication with your leads and deal contacts directly within Frappe CRM.

Important Note: Due to WhatsApp Business limitations, you can only initiate communication by sending a pre-approved WhatsApp template. You can only send regular messages after receiving a reply from the customer.

On this page