Download the PHP package botpenguin/module-connector without Composer
On this page you can find all versions of the php package botpenguin/module-connector. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download botpenguin/module-connector
More information about botpenguin/module-connector
Files in botpenguin/module-connector
Package module-connector
Short Description Pushes signed Magento store events (orders, customers, abandoned carts) to the configured webhook for WhatsApp automation.
License OSL-3.0
Informations about the package module-connector
BotPenguin_Connector (Magento 2)
Pushes signed Magento store events — orders, new customers, abandoned carts — to a configured webhook for WhatsApp automation.
- Supported: Magento Open Source & Adobe Commerce 2.4.4+, PHP 8.1+.
- Events:
order.created,order.updated,order.canceled,order.refunded,customer.created,cart.abandoned.
Installation
Composer (recommended)
Manual (zip / app/code)
Extract to app/code/BotPenguin/Connector, then run the same bin/magento commands as above.
Configuration
Stores → Configuration → BotPenguin → Connector → General:
- Enable — turn the connector on.
- Webhook URL — paste the URL from your dashboard (
…/custom-app/magento/{botApiKey}). - Signing Secret — paste the one-time secret from your dashboard (stored encrypted).
On Save Config, the module runs a one-time activation handshake with the webhook and shows a success/error message confirming the connection.
How it works
- Observers on
sales_order_place_after(created) andsales_order_save_after(status change → updated/canceled/refunded) build a normalized, versioned envelope and POST it to the Webhook URL. customer.createdfires when the customer first becomes reachable: at registration if a phone is present, otherwise the moment their first address with a telephone is saved (exactly once per customer).- A cron job (dedicated
botpenguin_connectorcron group, every 15 minutes) scans stale active quotes and emitscart.abandonedonce per cart. - Each request is signed:
X-Signature: v1=HMAC_SHA256(secret, "v1:{X-Timestamp}:{botApiKey}"), withX-Timestamp(unix seconds) andX-Delivery-Id. - Delivery is fail-safe (never disrupts checkout, order save, or registration).
Uninstall
Disabling stops all event delivery. Configuration values remain until removed from core_config_data.
License
Open Software License v3.0 (OSL-3.0) — see LICENSE.txt.
All versions of module-connector with dependencies
magento/framework Version ^103.0
magento/module-config Version ^101.2
magento/module-cron Version ^100.4
magento/module-customer Version ^103.0
magento/module-quote Version ^101.2
magento/module-sales Version ^103.0
magento/module-store Version ^101.1