Shumoul WhatsApp Integration — Developer Guide
The Shumoul WhatsApp Integration gives the platform a complete WhatsApp Business messaging layer — Meta Cloud API connectivity, webhook handling, template messaging, and a real-time inbox — powering the ERP's customer communication features.
Who it's for: Backend Developers · Angular Developers · Flutter Developers · QA Engineers
| Field | Value |
|---|---|
| Status | Production Ready |
| Version | Latest |
| Last Updated | 2026-07-05 |
| Maintained By | Shumoul Engineering |
| Documentation | Official Developer Guide |
| Source of Truth | Shumoul Platform Source Code |
See Chapter 1 — Overview for how this module is scoped and how it relates to the Notification Framework.
Chapters
- Cover
- Table of Contents
- Overview
- Architecture
- Packages
- Configuration
- Runtime Flows
- API Reference (74 endpoints, 9 controllers)
- SignalR
- Webhooks
- Templates
- Inbox / Conversation
- Security
- Testing
- Troubleshooting
- Appendix
- SDK Code Examples — cURL, JS, C#, Flutter for all 74 endpoints
- Architecture Validation — Phase 2.2 findings
- SDK Usage Guide
- Configuration Reference
- Webhook Payload Catalog
- Meta Error Reference
- Sequence Diagrams
Official Postman Collection: Shumoul-WhatsApp-Integration.postman_collection.json
(also in the repo at static/postman/) — 75 requests across 11 folders (Authentication, Webhook
Verification, Templates, Conversations, Inbox, Notes, Saved Replies, Tags, Timeline, Diagnostics,
Communication APIs).
Source of Truth
This documentation is written directly against the shipped implementation in Shumoul.Saas.Api and
Shumoul.Saas.WhatsAppIntegration and independently re-verified against it. Engineers looking for the
underlying architecture records and design-decision history can find them referenced from
Chapter 4 — Architecture and
§18 Architecture Validation, which also documents two known,
not-yet-fixed findings from that re-verification pass.