MODULES / OPERATIONS
WhatsApp Share
Adds a Send on WhatsApp option to invoices, quotations, orders, deliveries, payments, bills and notes. It prepares the message from a template you control, opens the customer's chat when their mobile number is on file, and sends the document as a secure PDF link.
Overview
| Module id | ask_whatsapp_share |
|---|---|
| Version | 1.0.0 |
| Who uses it | Anyone who sends documents to customers or vendors. |
| Installed | On demand, from Settings → Modules. Anything it needs is installed with it. |
Step-by-step guides
How it links to other modules
- Needs: Core
- Works better with: Invoicing, Vendor Bills, Inventory
- Needed by: no other module
A module that is needed cannot be turned off while the module that needs it is on.
Details
WhatsApp Share (ask_whatsapp_share)
Adds Send on WhatsApp to: invoices and credit notes (gear menu, next to Send by email), quotations, sales orders, delivery challans, customer and vendor payments, vendor bills, debit notes and purchase orders.
How it works
- Open the document and choose Send on WhatsApp.
- Pick the message language (English or Urdu) and, where there are several, the PDF version: invoice (standard, with previous balance, with aging, with discount breakdown), payment (half or full page receipt), delivery (challan, Urdu gate pass, delivery gate pass).
- The message is prepared from your template and can be edited in the box.
- Open WhatsApp opens WhatsApp Web with the message. If the customer or vendor has a mobile (or phone) number on their profile, that chat opens directly; otherwise WhatsApp Web asks you to pick the chat.
- Press send in WhatsApp.
The PDF
WhatsApp Web has no way for a website to attach a file. So the PDF goes in two ways:
- Link in the message (default, can be unticked): a secure, signed link to that exact PDF. The recipient opens it without signing in. It works for invoices, quotations, orders and deliveries, and expires after 14 days. It opens that one document only and runs with the sender's rights.
- Copy document image and open WhatsApp (invoices and quotations): WhatsApp Web accepts a pasted image, so the document is copied as an image and the chat opens; click the message box and press Ctrl + V, then send. This is the way to put the document itself into a WhatsApp Web chat.
- Share PDF file: on a phone, or a computer with the WhatsApp app, this attaches the real PDF through the device share sheet.
- Open PDF to attach: opens the chosen version in a tab so it can be dragged into the chat.
Message templates
Settings -> WhatsApp messages: one English and one Urdu template per document type. Placeholders: {{customer}} (the vendor on vendor documents), {{number}}, {{amount}}, {{date}}, {{due_date}}, {{items}}, {{company}}. Leave a template empty to return to the default. Example: Dear {{customer}}, your invoice {{number}} for {{amount}} is ready.
Phone numbers
The profile mobile is used, else the phone. A leading 0 becomes the Pakistan code 92; numbers with + or 00 keep their own country code.
Also added with this add-on
- Purchase order PDF
/purchase-orders/{id}/pdf, sales order PDF/sales/orders/{id}/pdf, vendor bill PDF/purchase/vendor-bills/{id}/pdf. - The delivery challan PDF no longer needs the logistics add-on.
ASKERP sends nothing and stores no WhatsApp account or key. Templates are stored in ask_whatsapp_template (migrations 0139 and 0140).