whatsapp-agenium-bridge
v1.0.0
Published
WhatsApp Business API Bridge for the agent:// protocol (Agenium)
Downloads
106
Maintainers
Readme
WhatsApp-Agenium Bridge
WhatsApp Business API Bridge for the agent:// protocol (Agenium). Connects WhatsApp Business Cloud API to the agent:// network, enabling agents to send/receive WhatsApp messages, use commerce catalogs, interactive flows, and payments.
Features
- 📨 Bidirectional messaging — WhatsApp ↔ agent:// protocol
- 🔘 Interactive messages — Buttons, lists, location sharing
- 🛍️ Commerce Catalog — Product browsing and sharing
- 📝 WhatsApp Flows — Interactive forms and surveys
- 💳 Payments — Order processing (India/Brazil)
- 📋 Templates — Outbound template message management
- 👥 Groups — Group chat bridging
- 🏥 Health monitoring — Heartbeat registration with Agenium DNS
- 🔐 Webhook verification — HMAC signature validation
Quick Start
npm install
cp .env.example .env
# Configure your credentials
npm run build && npm startArchitecture
WhatsApp Cloud API ←→ [Bridge] ←→ agent:// protocol
↓
Agenium DNS
(185.204.169.26:3000)API
| Endpoint | Method | Description |
|---|---|---|
| /.well-known/agent.json | GET | Agent card |
| /agent/message | POST | Send WhatsApp message |
| /agent/tasks | POST | Create task |
| /agent/tasks/:id | GET | Task status |
| /agent/receive | POST | Receive agent message |
| /webhook | GET/POST | WhatsApp webhook |
| /health | GET | Health check |
License
MIT
Bug Reporting
This project includes optional bug reporting to the Agenium monitoring server.
Configuration
Set the following environment variables to enable bug reporting:
BUG_REPORT_URL=http://130.185.123.153:3100
BUG_REPORT_TOKEN=your_token_hereBug reporting is disabled by default — it only activates when BUG_REPORT_TOKEN is set. Reports are sent asynchronously (fire and forget) and never block the main application.
