Skip to content

Add webhook notification agent example for event-driven integration#331

Open
MayurUghade03 wants to merge 1 commit intoGetBindu:mainfrom
MayurUghade03:add/webhook-notification-agent
Open

Add webhook notification agent example for event-driven integration#331
MayurUghade03 wants to merge 1 commit intoGetBindu:mainfrom
MayurUghade03:add/webhook-notification-agent

Conversation

@MayurUghade03
Copy link

Summary

This PR adds a webhook notification agent example that demonstrates event-driven integration patterns for Bindu agents. When tasks complete, the agent sends HTTP POST notifications to external systems via webhooks.

Problem Solved

Shows how to integrate Bindu agents with external systems through webhooks when tasks complete - a common production requirement for real-time notifications and system integration.

Solution

  • Agent receives messages from Bindu framework
  • Processes tasks and sends HTTP POST to configurable webhook endpoint
  • Includes demo Flask receiver for local testing without external services
  • Follows official Bindu patterns (bindufy, handler contract)
  • Environment-based configuration for production deployment

Features

✅ Event-driven webhook notifications on task completion
✅ Environment-configurable endpoints (WEBHOOK_URL, WEBHOOK_TIMEOUT)
✅ Robust error handling with specific exception types
✅ Request tracking with unique UUIDs
✅ Timeout protection (configurable, default 5s)
✅ Local testing demo included (Flask receiver)
✅ Framework-agnostic pattern
✅ Production-ready code with type hints

Type of Change

  • New example in examples/webhook_notification_agent/
  • Documentation (comprehensive README with setup guide)

Files Added

  • examples/webhook_notification_agent/agent.py - Agent implementation (~150 lines)
  • examples/webhook_notification_agent/webhook_receiver_demo.py - Flask demo receiver
  • examples/webhook_notification_agent/README.md - Complete documentation
  • examples/webhook_notification_agent/requirements.txt - Minimal dependencies (3)

Testing Instructions

Quick Test

# 1. Install dependencies
pip install -r examples/webhook_notification_agent/requirements.txt

# 2. Terminal 1: Start webhook receiver
python examples/webhook_notification_agent/webhook_receiver_demo.py

# 3. Terminal 2: Run agent
python examples/webhook_notification_agent/agent.py

Copilot AI review requested due to automatic review settings March 5, 2026 19:02
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants