WhatsApp Client

Browser-based calling interface for WhatsApp Calling Platform.

Overview

WhatsApp Client is a lightweight Frappe app that provides a browser-based calling interface for agents. It connects to your hosted WhatsApp Calling backend API.

Features

• ✅ Click-to-call buttons in CRM Lead, Contact forms
• ✅ Browser-based WebRTC calling interface
• ✅ Call history tracking
• ✅ WABA connection via embedded signup
• ✅ Real-time call controls (mute, end call)
• ✅ Call duration timer

Installation

# Get the app
cd frappe-bench
bench get-app https://github.com/your-org/whatsapp_client

# Install on site
bench --site your-site.local install-app whatsapp_client

Configuration

After installation, configure the backend connection:

1. Go to: WhatsApp Client Settings
2. Enter:
   • Backend URL: https://api.yourvendor.com
   • API Key: (provided by your vendor)
3. Save
4. Click "Connect WhatsApp Business" to link your WABA

Usage

Making a Call

1. Open any Lead or Contact in Frappe desk
2. Click "WhatsApp Call" button
3. Call interface opens automatically
4. Grant microphone permission (first time)
5. Use mute/end call controls as needed

Viewing Call History

Click "Call History" button in Lead/Contact forms to see past calls.

Architecture

WhatsApp Client is a frontend-only app that:

• Contains only JavaScript and CSS (no Python business logic)
• Makes API calls to your hosted backend
• Does NOT store WABA credentials locally
• Connects to your vendor's Janus WebRTC server

Requirements

• Frappe Framework v14 or higher
• Modern browser (Chrome 90+, Firefox 88+, Safari 14+)
• Microphone permission
• HTTPS (in production) or localhost

Support

For issues or questions:

• GitHub Issues: https://github.com/your-org/whatsapp_client/issues
• Documentation: [Coming soon]

License

MIT