OpenClaw Agent
84 lines
2.5 KiB
Markdown
84 lines
2.5 KiB
Markdown
---
|
|
name: webhook-gen
|
|
description: Generate webhook handlers with retry logic using AI. Use when integrating Stripe, GitHub, or any webhook provider.
|
|
---
|
|
|
|
# Webhook Generator
|
|
|
|
Describe the webhook you're handling. Get a complete handler with signature verification, retry logic, and proper error handling. Stripe, GitHub, Twilio. all the patterns you need.
|
|
|
|
**One command. Zero config. Just works.**
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
npx ai-webhook "stripe payment succeeded"
|
|
```
|
|
|
|
## What It Does
|
|
|
|
- Generates complete webhook handler functions
|
|
- Includes signature verification for popular providers
|
|
- Adds idempotency checks to prevent duplicate processing
|
|
- Implements retry-safe patterns with proper status codes
|
|
- Handles common webhooks from Stripe, GitHub, Shopify, and more
|
|
|
|
## Usage Examples
|
|
|
|
```bash
|
|
# Stripe payment webhook
|
|
npx ai-webhook "stripe checkout.session.completed"
|
|
|
|
# GitHub push events
|
|
npx ai-webhook "github push event to trigger deployment"
|
|
|
|
# Generic webhook with retry
|
|
npx ai-webhook "order created webhook with idempotency"
|
|
|
|
# Specify provider explicitly
|
|
npx ai-webhook "new subscriber notification" --provider convertkit
|
|
|
|
# TypeScript output
|
|
npx ai-webhook "invoice paid" --typescript
|
|
```
|
|
|
|
## Best Practices
|
|
|
|
- **Always verify signatures** - Never trust raw webhook payloads
|
|
- **Return 200 quickly** - Process async. Don't make providers wait
|
|
- **Handle duplicates** - Webhooks retry. Your handler should be idempotent
|
|
- **Log everything** - Debugging webhook issues without logs is painful
|
|
|
|
## When to Use This
|
|
|
|
- Integrating a payment provider like Stripe or Paddle
|
|
- Setting up GitHub Actions alternatives with webhooks
|
|
- Building notification systems triggered by external services
|
|
- Any third-party integration that sends webhooks
|
|
|
|
## Part of the LXGIC Dev Toolkit
|
|
|
|
This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.
|
|
|
|
**Find more:**
|
|
- GitHub: https://github.com/LXGIC-Studios
|
|
- Twitter: https://x.com/lxgicstudios
|
|
- Substack: https://lxgicstudios.substack.com
|
|
- Website: https://lxgic.dev
|
|
|
|
## Requirements
|
|
|
|
No install needed. Just run with npx. Node.js 18+ recommended.
|
|
|
|
```bash
|
|
npx ai-webhook --help
|
|
```
|
|
|
|
## How It Works
|
|
|
|
The tool recognizes common webhook patterns from your description. It generates a handler function with the appropriate verification method, event parsing, and response codes. AI ensures the handler follows best practices for reliability and security.
|
|
|
|
## License
|
|
|
|
MIT. Free forever. Use it however you want.
|