WhatsApp Cloud API Integration & Automation Module

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

Store Module Supported Events Order Order Created, Order Deleted, Order Completed, Order Placed, Order Cancelled, Payment Confirmed, Order Confirmed, Order Returned Shipping Shipping Status Changed Vendor Vendor Registered Customer Customer Created, Customer Updated, Customer Deleted, Email Verified Invoice Invoice Created, Invoice Deleted User User Created, User Updated, User Deleted 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