How do I integrate Perfex CRM with WhatsApp API?
Connect Perfex CRM to WhatsApp Business API — official module, invoice triggers, proposal follow-ups, and support tickets on one business number. Self-hosted PHP CRM integration without QR hacks. Install the Ominiflow Perfex module, connect your WhatsApp Business API account, map staff and phone fields, submit Meta templates, and enable automations on invoice, lead, and ticket events.
Last updated: 6 July 2026
Your agency sends invoices from Perfex. Clients open email 22% of the time. Payment chases happen on personal WhatsApp — invisible to managers, lost when staff leave. Perfex CRM WhatsApp integration on the official Business API fixes the loop: invoice status changes trigger utility templates; replies land in a shared inbox and log on the customer record.
Perfex (MSTdev) is a popular self-hosted PHP CRM for agencies, freelancers, and SMB sales teams — leads, estimates, invoices, projects, tickets. It has no native Meta WhatsApp connector. Marketplace modules range from QR-based unofficial tools to Ominiflow's Cloud API module. This guide covers the official path, field mapping, automations that pay for themselves, and mistakes that get numbers restricted.
Start here
- Perfex + Ominiflow module = WhatsApp on official Cloud API with CRM timeline logging
- Setup: upload module → API key → map staff → test lead → enable automations (~45–90 min)
- Phone field:
phonenumberin E.164 (919876543210for India) - Business-initiated messages need approved templates; customer replies open 24h session
- Avoid QR/unofficial plugins for team workflows — ban risk, no template compliance
- General integration architecture: WhatsApp API integration guide
What Perfex CRM is
Perfex is a PHP-based CRM (self-hosted or cloud VPS) used heavily by:
- Digital marketing and web development agencies on retainers
- Freelancers tracking proposals, time, and invoices
- Real-estate brokers and channel partners
- IT consultancies linking projects to billing
- SMB inside-sales in India, UAE, Southeast Asia, Africa, Europe
Core entities: leads, customers, contacts, estimates, invoices, proposals, tickets, projects, contracts, expenses. REST API at /api/ for leads, customers, invoices, tasks. Docs: Perfex help · API docs
Why integrate Perfex with WhatsApp API
| Without integration | With Perfex + Ominiflow |
|---|---|
| Reps use personal phones | One business number, audited inbox |
| Invoice email ignored | Utility template + PDF on "invoice sent" |
| Proposal follow-up in manager's head | Stage-triggered 3-touch sequence |
| Support tickets email-only | WhatsApp thread linked to ticket |
| No reply-rate data | Read receipts on customer record |
Perfex WhatsApp options (honest comparison)
No built-in official API. Teams typically choose:
- Unofficial QR modules — consumer WhatsApp Web automation. Cheap until the number gets banned. No team inbox at scale.
- Manual copy-paste — Business app on one phone. Doesn't scale past ~5 clients.
- External BSP + CSV loops — WATI/Interakt with export/import. Works until volume breaks.
- Ominiflow Perfex module — official Cloud API, templates, inbox, webhooks, CRM logging.
How Perfex and WhatsApp connect
- Perfex event — lead created, invoice sent, ticket updated, estimate approved
- Ominiflow module / webhook — maps fields to template JSON
- Ominiflow BSP — template validation, queue, inbox routing
- Meta Cloud API — delivery to customer
- Inbound reply — webhook → inbox → Perfex timeline + optional ticket update
Same chain as any CRM — see integration guide for webhook signature verification, HTTP 200 ack, and idempotency on message.id.
Setup walkthrough
Prerequisites
- Perfex admin access (Setup → Modules)
- Ominiflow account with WABA connected
- Dedicated phone number (not on consumer WhatsApp)
- Meta Business Manager verified
- Templates: invoice sent, payment reminder, proposal follow-up, welcome lead
Step 1: Ominiflow WhatsApp API
- Connect business number; wait for CONNECTED status
- Submit and approve templates
- Copy API key and webhook secret from dashboard
Step 2: Install Perfex module
- Perfex → Setup → Modules → Upload Ominiflow module ZIP
- Activate module → open WhatsApp settings tab
- Paste API key, webhook secret, inbound webhook URL
- Map Perfex staff users to Ominiflow agent accounts
- Enable logging on leads, customers, invoices, tickets
Step 3: Field mapping
| Perfex field | WhatsApp use |
|---|---|
phonenumber | E.164 — prepend country code (91 for 10-digit India) |
| Client name | Template {{1}} |
| Invoice # / amount | {{2}}, {{3}} on billing templates |
| Estimate link | Button URL on proposal sent |
Custom: whatsapp_conversation_id | Reply matching (recommended) |
Step 4: Test before production
- Create sandbox lead with your mobile
- Trigger welcome template from lead create rule
- Reply from phone — confirm inbox assignment and Perfex timeline log
- Send test invoice event — verify PDF delivery
Step 5: REST API extension (optional)
Perfex API at /api/ lets Ominiflow webhooks create leads or append ticket replies on inbound messages. Store last_whatsapp_at in custom fields for reporting.
Workflows that pay for Perfex teams
Invoice sent → WhatsApp + PDF
Invoice status → "sent" fires utility template with payment link. Mumbai agency case: median collection time dropped from 11 days to 4 days when email-only reminders became WhatsApp-primary.
Overdue invoice ladder
Day 1 gentle → day 7 firm → day 14 escalation + call task in Perfex. Each step utility template with pay-now link.
Proposal / estimate follow-up
Stage "proposal sent" → day 0, 2, 5 templates; pause on reply. Bangalore IT consultancy improved win rate on stale proposals because every thread logs on customer record.
New website lead → instant welcome
Form creates lead → welcome template in 60s → assign owner in inbox. Replaces next-day callback culture.
Inbound WhatsApp → support ticket
Customer messages business number → ticket created with department tag → status updates push utility templates on ticket change.
Dubai real-estate example
Portal leads into Perfex → English-Arabic welcome in 90s → round-robin agent → site-visit confirmation buttons. No-show rate dropped 18% in one quarter when confirmations moved from phone tag to structured WhatsApp.
Official API vs unofficial Perfex plugins
| Capability | QR / unofficial | Ominiflow + Perfex |
|---|---|---|
| Meta Cloud API | No | Yes |
| Multi-agent inbox | No | Yes |
| Template compliance | No | Yes |
| CRM timeline logging | Manual | Automatic |
| Bulk campaigns | Ban risk | Opt-in + marketing templates |
| Webhook / REST API | Unreliable | Documented |
Common mistakes
- 10-digit Indian numbers without
91prefix — silent failures - Marketing templates on cold lead imports — quality rating crash
- Free-form invoice reminders outside 24h window — need utility template
- Webhook secrets in git — rotate via module settings only
- Every staff member with send permission — use RBAC
- Skipping sandbox test on real client numbers
More: common API mistakes · ban prevention
Migrating from WATI, Interakt, or manual WhatsApp
- Export templates and opt-in records from old provider
- Migrate number to Ominiflow WABA (remove from consumer app first)
- Install Perfex module; parallel-run 1 week if needed
- Recreate automations on Perfex triggers — don't rely on CSV loops
Checklist: BSP migration checklist
What it costs
Ominiflow platform plan + Meta per-conversation fees (India utility ₹0.115, marketing ₹0.86 — verify on Meta rate card). Agency with 2,000 invoice reminders/month ≈ ₹230 Meta utility + platform fee. Pricing guide
Get Perfex + WhatsApp live
Official module, template management, shared inbox, chatbots, webhooks. We help agencies map Perfex automations to compliant templates.
Related: WhatsApp API integration guide · Zoho integration · WhatsApp API India · free workshop
FAQ
Does Perfex have built-in WhatsApp API? expand_more
No official Meta connector. Use Ominiflow's Perfex module or external BSP with webhooks/API.
How long does setup take? expand_more
45–90 minutes for module install and connection; 24–48 hours parallel for Meta template approval.
Does it work on self-hosted Perfex? expand_more
Yes. Module connects via API/webhooks; server must reach Ominiflow endpoints outbound and receive webhooks inbound (HTTPS).
Can I send invoice PDFs on WhatsApp? expand_more
Yes — document message or secure link via utility template when invoice is sent in Perfex.
Can multiple agents share one WhatsApp number? expand_more
Yes — Ominiflow shared inbox with assignment, notes, and supervisor visibility.
Is QR-based Perfex WhatsApp safe? expand_more
Not for scale. Unofficial automation risks bans and offers no template compliance or team audit trail. Last updated July 2026. Perfex module features — confirm with Ominiflow support for your Perfex version.
