WhatsApp Cloud API Integration & Automation Module for Shofy – eCommerce & Multivendor Marketplace

Requirement: This addon requires an active installation of Shofy – eCommerce & Multivendor Marketplace and a verified Meta WhatsApp Business Account with Cloud API access enabled.

Brief Description

The WhatsApp Cloud API Integration & Automation Module for Shofy enables real-time WhatsApp communication between your store and customers using Meta’s official WhatsApp Cloud API. Automatically send order confirmations, shipping updates, customer notifications, and marketplace alerts directly from your Shofy installation.

This addon is built specifically for Shofy and operates entirely within your own hosting environment. It allows you to connect your WhatsApp Business Account, sync approved templates, map store events to automated messages, and monitor delivery status through detailed activity logs.

Key Features

• Official WhatsApp Cloud API Integration
  Direct integration with Meta’s official WhatsApp Cloud API without third-party or unofficial gateways.
• Secure Account Connection
  Configure Facebook App ID, App Secret, WABA ID, and permanent access tokens with built-in connection validation and health checks.
• WhatsApp Business Account Dashboard
  View access token details, permission scopes, phone number quality rating, messaging limits, and webhook status in one place.
• Template Synchronization
  Sync and manage approved WhatsApp templates including marketing, utility, and authentication categories.
• Event-Based Template Mapping
  Automatically send WhatsApp notifications when important store events happen, such as order updates, payments, shipping changes, vendor registrations, and customer account actions.
• Dynamic Merge Fields
  Inject dynamic store data such as order ID, customer name, totals, and tracking details into WhatsApp templates.
• Send Test Messages
  Validate API configuration and templates before activating production automations.
• Incoming Message Handling
  Receive and process WhatsApp webhook events directly inside your Shofy application.
• Auto Convert to Contact
  Automatically create contacts from incoming WhatsApp messages.
• Webhook Forwarding
  Forward incoming WhatsApp webhook payloads to external services or automation platforms.
• Comprehensive Activity Logs
  Track message status including accepted, delivered, and API response data for complete transparency.

Supported Features / Events

Note: Merge fields will be automatically available based on which events you are selecting.

Technical Details / Architecture

This addon communicates directly with Meta’s WhatsApp Cloud API using secure REST requests and verified webhooks. All outgoing messages are template-based and compliant with Meta policies.

• Direct server-to-server API communication
• Webhook-based delivery and status updates
• Event listeners integrated with Shofy modules
• Secure token-based authentication
• Full API response logging for debugging
• Runs entirely within your self-hosted Shofy environment

Who Can Use This Item?

• eCommerce Store Owners
  Automatically notify customers about orders, payments, and shipping updates via WhatsApp.
• Marketplace Operators
  Send event-driven notifications to customers and vendors within multivendor setups.
• Customer Support Teams
  Receive and track WhatsApp communications inside Shofy with proper logging.
• Automation-Focused Businesses
  Integrate WhatsApp messaging into store workflows without relying on external gateways.

Real Use Cases

• Order Confirmation & Updates
  When a customer places an order, they instantly receive a WhatsApp confirmation with order details, amount, and estimated delivery. As the order moves through stages (confirmed, completed, cancelled, or returned), automated notifications keep them informed.
• Payment Notifications
  Send instant WhatsApp alerts when payment is confirmed, reassuring customers that their transaction was successful and their order is being processed.
• Shipping Tracking Updates
  Automatically notify customers via WhatsApp whenever their shipping status changes, providing tracking details and expected delivery dates without manual intervention.
• Vendor Onboarding
  When a new vendor registers on your marketplace, send them a personalized WhatsApp welcome message with account details, next steps, and support information.
• Customer Account Management
  Send WhatsApp notifications for account creation, profile updates, and email verification confirmations, enhancing customer engagement and trust.
• Invoice Generation Alerts
  Notify customers or vendors immediately when invoices are created, with direct links or reference numbers for easy access and record-keeping.
• Order Return Process
  When a customer initiates a return, automatically send WhatsApp messages with return instructions, tracking details, and refund timelines.

Why Choose This Item?

• Uses Meta’s official WhatsApp Cloud API
• Built specifically for Shofy eCommerce
• Event-driven automation architecture
• Full visibility with activity logs
• No dependency on unofficial providers
• Designed for self-hosted environments

How to Install & See the Module in Action

Step-by-step installation and configuration instructions are provided in the online documentation. The guide covers Meta App setup, access token generation, webhook configuration, template synchronization, and event mapping.

Watch the complete video tutorial: https://youtu.be/1VZCd6BkxrQ

The video demonstrates account connection, template mapping, event configuration, and real-time automation setup in action.

Support & Questions

Support includes installation guidance, configuration assistance, and bug fixes related to the addon. Meta account approval, WhatsApp template approval, and policy compliance remain the Buyer’s responsibility.

Changelog

Version 1.0.0

• Initial release
• WhatsApp Cloud API integration for Shofy
• Template synchronization and mapping
• Event-driven WhatsApp automation
• Incoming webhook handling and activity logs

Important Notes

• WhatsApp messaging fees are charged directly by Meta
• Only Meta-approved templates can be used for outbound messaging
• HTTPS is required for webhook functionality
• Meta Business verification and setup are Buyer’s responsibility