Perimattic
communication

ERPNext WhatsApp Integration - Invoices, Helpdesk 2-Way Inbox & Work Order Updates

The ERPNext-WhatsApp connector leverages ERPNext's native Frappe webhook system for real-time bidirectional messaging. It sends invoices from Selling and Accounts modules, converts WhatsApp customer conversations into ERPNext Helpdesk tickets, pushes Work Order status updates from Manufacturing, and delivers Project task alerts to assignees — all with Frappe DocType field interpolation and Custom Field support. Runs on self-hosted ERPNext and Frappe Cloud without app installation on the ERPNext instance itself. Rs 2,499/month for Indian businesses or $99/month internationally.

Native Frappe-webhook ERPNext <-> WhatsApp Business with two-way helpdesk ticketing, work-order alerts, and manufacturing dispatch coverage.

ERPNext
WhatsApp Business
5-minute setup30-day money backNo coding required
Overview

What this connector does

ERPNext is different from other ERPs in the ERPPlugs catalog — it is modern, multi-module, and webhook-native. Frappe (the framework ERPNext is built on) exposes every DocType change as an event that any external service can subscribe to. This connector uses that primitive as its foundation, so integration is event-driven rather than polling-based. A Sales Invoice submission fires a webhook that the connector receives in milliseconds, renders through a Frappe DocType-aware template, and delivers over WhatsApp. Two-way conversations round-trip cleanly: a customer WhatsApp reply is captured, a Helpdesk Ticket DocType is created (or updated) via ERPNext's REST API, and the reply thread is stored as Communication records linked to that ticket. This works out of the box on self-hosted ERPNext (v14 and v15) and on Frappe Cloud. No custom Frappe app needs to be installed on the ERPNext instance itself — the connector uses only stock DocTypes, stock webhooks, and the standard REST API.

Architecture & Sync

How data flows and what gets synced

The bridge between ERPNext and WhatsApp Business, and the exact records that move across it.

Data flow
ERPNext

ERPNext

ERPPlugs

ERPPlugs Engine

WhatsApp Business

WhatsApp Business

What flows across
Sales InvoicesPayment Entry RemindersHelpdesk TicketsWork Order StatusProject Task AlertsCustomer Master SyncPOS Returns
Sync details
Data TypeDirectionFrequency
Sales InvoicesERPNext → WhatsAppReal-time (webhook)
Payment Entry RemindersERPNext → WhatsAppDaily on aging schedule
Helpdesk TicketsWhatsApp ↔ ERPNext HelpdeskReal-time (bidirectional)
Work Order StatusERPNext → WhatsApp (shop-floor)Real-time
Project Task AlertsERPNext → Assignee WhatsAppReal-time on assign or status change
Customer Master SyncERPNext ↔ ERPPlugsReal-time (webhook)
POS ReturnsERPNext → WhatsAppReal-time on POS return
How this connector compares

Alternative ERPNext <-> WhatsApp Business integrations available to Indian businesses, and where each fits.

ConnectorTypeWhatsApp Business SupportTypical Capabilities
ERPNext <-> WhatsApp BusinessThis pageNative ERP connector✓ NativeFrappe-webhook driven — real-time invoice, order, and DocType change events, Sales Invoice → WhatsApp PDF with Frappe field interpolation, Two-way Helpdesk ticket creation from customer WhatsApp replies
ERPNext community appFrappe/Bench moduleFull (self-hosted)
Frappe Cloud native integrationManaged Frappe hostingPartial (limited catalogue)
Custom Frappe scriptIn-house Frappe developmentFull (developer required)
Capabilities

What's included

Frappe-webhook driven — real-time invoice, order, and DocType change events
Sales Invoice → WhatsApp PDF with Frappe field interpolation
Two-way Helpdesk ticket creation from customer WhatsApp replies
Work Order status updates broadcast to shop-floor WhatsApp groups
Project task assignment alerts to assignee WhatsApp
POS Invoice returns and refunds fire WhatsApp confirmations
Custom DocType support — subscribe to your custom-built modules
Custom Field interpolation — render any field you have added to Sales Invoice or Customer
Multi-company ERPNext support with per-company WhatsApp Business numbers
Works on self-hosted ERPNext (v14, v15) and Frappe Cloud
No custom Frappe app to install — uses stock DocTypes and REST API
Signed webhook callbacks with HMAC signature for downstream systems
Why It Matters

Key Benefits

Webhook-Native Real-Time

Frappe events fire the connector in milliseconds — no polling delay.

Helpdesk 2-Way Tickets

Customer WhatsApp replies become ERPNext Helpdesk tickets automatically.

Custom DocType Ready

Any custom module in your ERPNext instance can drive WhatsApp events.

Frappe Cloud + Self-Hosted

Works identically on Frappe Cloud and self-hosted v14/v15 deployments.

Free to Try

Try the ERPNext <-> WhatsApp Business Connector Free

Start with 1 connector and 100 transactions/month — no credit card required. See real data flowing between ERPNext and WhatsApp Business inside 5 minutes.

Compliance & Setup

Compliance-ready. Live in minutes.

What you get out of the box for statutory compliance — and the exact steps to go live.

Setup in Minutes

1

Generate ERPNext API Token

From ERPNext → User → API Access, generate an API Key and API Secret for the ERPPlugs system user with permissions on Sales Invoice, Customer, HD Ticket, Work Order, and any Custom DocTypes you want to sync.

2

Configure ERPNext Webhook

In ERPNext → Setup → Integrations → Webhook, add Perimattic's ingest endpoint for each DocType you want real-time delivery for (Sales Invoice, Payment Entry, HD Ticket, Work Order). Signed HMAC is auto-negotiated.

3

Connect WhatsApp Business

Link your Meta WhatsApp Business Account. Register phone numbers per ERPNext Company. Perimattic assists with template pre-approval for invoices, helpdesk auto-replies, and work order status.

4

Test & Enable

Trigger a test Sales Invoice submission and verify webhook delivery and WhatsApp PDF receipt. Send a WhatsApp reply to verify Helpdesk ticket creation. Enable production DocType subscriptions from the dashboard.

Pricing

Simple, Transparent Pricing

Start free, upgrade as you grow.

Free Forever

Free

Free
  • 1 connector (read-only sync)
  • Daily sync (manual trigger)
  • Basic GST compliance (CGST, SGST, IGST)
  • HSN code auto-mapping
  • Community support
  • Standard sync-status dashboard
  • ERPPlugs branding on reports
  • Data retention (30 days)

Starter

2,499/mo
  • 1 connector (read-write sync)
  • 15-minute sync intervals
  • Full GST compliance (CGST, SGST, IGST, RCM)
  • HSN and SAC auto-classification
  • Email support (48-hour response)
  • Bank reconciliation with UTR matching
  • Multi-user access (up to 3 users)
  • Standard reporting dashboard
  • No ERPPlugs branding on reports
  • Data retention (12 months)
Most Popular

Growth

4,999/mo
  • 3 connectors (read-write sync)
  • Real-time sync (under 30 seconds)
  • Full GST compliance + e-invoice + e-way bill
  • HSN, SAC, and TDS auto-classification
  • Priority support (4-hour response)
  • Bank reconciliation across multiple accounts
  • Multi-user access (up to 10 users)
  • Custom field mapping and transformations
  • Advanced analytics dashboard
  • Webhook notifications for every event
  • Scheduled reports (daily / weekly / monthly)
  • Data retention (36 months)
Best Value

Enterprise

14,999/mo
  • Unlimited connectors
  • Real-time sync with sub-second latency
  • Dedicated account manager (1-hour SLA)
  • Full GST + e-invoice + e-way bill + IRN
  • White-label option (your brand on reports)
  • Custom field mapping and business logic
  • Advanced analytics + custom BI exports
  • Webhook notifications with retry and DLQ
  • SSO and role-based access control
  • Custom SLA with uptime guarantees
  • Onboarding workshop and dedicated CS team
  • Data retention (7 years) and audit export
  • India-region data residency (DPDP-aligned)
Answers

Frequently Asked Questions

No. The ERPPlugs ERPNext-WhatsApp connector uses only stock ERPNext primitives — outgoing webhooks configured in the ERPNext Webhook DocType, and the standard REST API for reads and writes. Nothing is added to your ERPNext instance beyond configuration. This means the connector is safe for Frappe Cloud (where you cannot install custom apps freely), safe for restricted production environments where every custom app has to go through change control, and immune to the app-collision issues that come from installing multiple third-party Frappe apps. The connector operates entirely from Perimattic's cloud, calling ERPNext's REST API with an API token you generate from ERPNext's User settings.

Yes, this is one of the primary use cases. When a customer replies over WhatsApp, the connector checks whether an open HD Ticket exists for that customer + WABA phone number. If yes, the reply is appended as a Communication record on the existing ticket. If no, a new HD Ticket is created via ERPNext's Helpdesk API with the customer's Customer DocType linked, priority set from a keyword-detection rule, and initial description populated with the WhatsApp message body. Your Helpdesk agents work the ticket queue as they normally would in ERPNext; agent replies typed into the Helpdesk UI are pushed back out over WhatsApp automatically. This turns WhatsApp into a first-class ERPNext Helpdesk channel.

Yes. The connector's template renderer resolves any field on any DocType you can address through ERPNext's REST API, including Custom DocTypes and Custom Fields. If you have added a Custom Field called "priority_tier" to your Sales Invoice, the WhatsApp template can interpolate {{ priority_tier }} into the outgoing message. Custom DocType subscriptions are configured the same way as stock DocType subscriptions — you create an ERPNext Webhook pointing at Perimattic's ingest endpoint, and the connector treats the payload identically. This preserves the value of the ERPNext customisations your implementation partner has invested in.

Yes, Frappe Cloud is fully supported. Frappe Cloud restricts which custom apps can be installed, but it does not restrict outgoing webhooks or REST API access, both of which are what the ERPPlugs ERPNext-WhatsApp connector uses. Setup on Frappe Cloud is actually the fastest path because outbound HTTPS is pre-configured and there is no server-side firewall to open. Self-hosted ERPNext instances require you to ensure Perimattic's ingest endpoint is reachable from your ERPNext server's egress — most self-hosted deployments already allow outbound HTTPS to arbitrary destinations, so no extra config is typically required.

On Work Order status changes in the ERPNext Manufacturing module (Draft → Not Started → In Process → Completed → Stopped), the webhook fires and the connector matches the Work Order to a configured WhatsApp group. Group binding is by BOM item, by warehouse, or by production department — you configure the routing rule once in the ERPPlugs dashboard. The message includes the Work Order number, item code, quantity, status, and a link to open the Work Order in ERPNext. This is how modern manufacturing shop floors communicate — WhatsApp is already open on every supervisor's phone, and forcing them into a separate app has never worked in the Indian mid-market.

Yes. ERPNext supports multi-company installations under one instance, and the ERPPlugs ERPNext-WhatsApp connector respects that boundary. Each ERPNext Company DocType can bind to its own WhatsApp Business phone number and its own template set. Sales Invoices tagged to Company A send from A's WABA; Sales Invoices tagged to Company B send from B's WABA. This is important for Indian group structures where separate companies operate under a single ERPNext instance for shared master data but need separate customer-facing sender identities.

Ready to connect ERPNext with WhatsApp Business?

Join thousands of Indian businesses automating their ERP workflows with ERPPlugs. Setup takes under 5 minutes.