PHPackages                             botpenguin/module-connector - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. botpenguin/module-connector

ActiveMagento2-module

botpenguin/module-connector
===========================

Pushes signed Magento store events (orders, customers, abandoned carts) to the configured webhook for WhatsApp automation.

v1.0.2(3w ago)011OSL-3.0PHPPHP >=8.1

Since Jul 16Pushed 3w agoCompare

[ Source](https://github.com/bot-penguin/bp-magento)[ Packagist](https://packagist.org/packages/botpenguin/module-connector)[ RSS](/packages/botpenguin-module-connector/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)Dependencies (14)Versions (4)Used By (0)

BotPenguin\_Connector (Magento 2)
=================================

[](#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
------------

[](#installation)

### Composer (recommended)

[](#composer-recommended)

```
composer require botpenguin/module-connector
bin/magento module:enable BotPenguin_Connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

### Manual (zip / app/code)

[](#manual-zip--appcode)

Extract to `app/code/BotPenguin/Connector`, then run the same `bin/magento` commands as above.

Configuration
-------------

[](#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
------------

[](#how-it-works)

- Observers on `sales_order_place_after` (created) and `sales_order_save_after` (status change → updated/canceled/refunded) build a normalized, versioned envelope and POST it to the Webhook URL.
- `customer.created` fires 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_connector` cron group, every 15 minutes) scans stale active quotes and emits `cart.abandoned` once per cart.
- Each request is signed: `X-Signature: v1=HMAC_SHA256(secret, "v1:{X-Timestamp}:{botApiKey}")`, with `X-Timestamp` (unix seconds) and `X-Delivery-Id`.
- Delivery is fail-safe (never disrupts checkout, order save, or registration).

Uninstall
---------

[](#uninstall)

```
bin/magento module:disable BotPenguin_Connector
```

Disabling stops all event delivery. Configuration values remain until removed from `core_config_data`.

License
-------

[](#license)

Open Software License v3.0 (OSL-3.0) — see [LICENSE.txt](LICENSE.txt).

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance95

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~21 days

Total

2

Last Release

24d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ab74f4be43525dd734e7dc0513908752df5c615b2fdf897fdf5a255cf6542781?d=identicon)[BotPenguin](/maintainers/BotPenguin)

---

Top Contributors

[![bot-penguin](https://avatars.githubusercontent.com/u/147901861?v=4)](https://github.com/bot-penguin "bot-penguin (6 commits)")[![yadivyanshu1](https://avatars.githubusercontent.com/u/200570915?v=4)](https://github.com/yadivyanshu1 "yadivyanshu1 (1 commits)")

### Embed Badge

![Health badge](/badges/botpenguin-module-connector/health.svg)

```
[![Health](https://phpackages.com/badges/botpenguin-module-connector/health.svg)](https://phpackages.com/packages/botpenguin-module-connector)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1162.0M19](/packages/mollie-magento2)[loki/magento2-components

Core module for defining Alpine.js components with advanced AJAX features

1019.5k30](/packages/loki-magento2-components)[run-as-root/magento2-prometheus-exporter

Magento2 Prometheus Exporter

68365.7k](/packages/run-as-root-magento2-prometheus-exporter)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50413.8k26](/packages/dotdigital-dotdigital-magento2-extension)[yireo/magento2-emailtester2

Preview transactional emails and test send them in your backend

34452.5k](/packages/yireo-magento2-emailtester2)[buckaroo/magento2

Buckaroo Magento 2 extension

32431.3k8](/packages/buckaroo-magento2)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)