frappe-webhook-manager

Create secure Frappe webhook receivers and senders with HMAC-SHA256 verification.

25|14|Updated Dec 15, 2025
One-click install
npx skills add https://github.com/Venkateshvenki404224/frappe-apps-manager --skill frappe-webhook-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frappe-webhook-manager
Source: https://github.com/Venkateshvenki404224/frappe-apps-manager/tree/main/frappe-apps-manager/skills/frappe-webhook-manager
Command: npx skills add https://github.com/Venkateshvenki404224/frappe-apps-manager --skill frappe-webhook-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Implementing event-driven integrations with external systems using webhooks in Frappe requires setting up secure receivers and reliable senders, which can be complex and error-prone. This Skill automates webhook generation.

Core Features & Use Cases

  • Webhook Receiver: Generate secure Python endpoints to receive webhooks from external services, including signature verification for authenticity.
  • Outgoing Webhook Sender: Create functions to send webhooks to external systems on specific Frappe document events (e.g., on_submit), complete with retry logic.
  • Asynchronous Processing: Integrate with Frappe's enqueue system for asynchronous webhook sending, preventing performance bottlenecks in your application.
  • Use Case: Generate a webhook receiver to process payment success notifications from a payment gateway, automatically updating the corresponding Sales Invoice status in Frappe.

Quick Start

Generate an outgoing webhook sender that triggers when a 'Sales Order' is submitted, sending its details to an external CRM system.

Frequently Asked Questions about frappe-webhook-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up secure webhook receivers for external service integrations in Frappe?

Secure webhook receivers in Frappe require HMAC-SHA256 signature verification to authenticate incoming requests from external services. This Skill generates Python endpoints that verify signatures against stored webhook secrets, parse JSON payloads, and route events to appropriate handlers, ensuring only legitimate notifications are processed.

Can I send webhooks from Frappe when documents are submitted or modified?

Yes, outgoing webhooks trigger on specific Frappe document events like on_submit. This Skill generates sender functions that post document details to external systems with built-in retry logic and asynchronous processing via Frappe's enqueue system, preventing application performance bottlenecks.

What's the best way to handle real-time payment notifications from payment gateways in Frappe?

Real-time payment notifications require webhook receivers that verify authenticity and update records automatically. This Skill generates secure endpoints that receive payment success webhooks, validate signatures using HMAC-SHA256, parse gateway payloads, and trigger handlers to update corresponding Sales Invoices without manual intervention.

How do I integrate Frappe webhooks asynchronously to avoid performance issues?

Asynchronous webhook integration uses Frappe's enqueue system to process outbound webhooks in background jobs. This Skill implements async sending with retry logic, allowing your application to queue webhook events without blocking user operations or delaying document processing.

Do I need to manage webhook secrets separately in Frappe configurations?

Webhook secrets should be loaded from Frappe configuration files rather than hardcoded. This Skill handles secret management and HMAC-SHA256 signature verification against configured values, ensuring secure authentication without exposing sensitive credentials in code.

What events can trigger webhooks when working with ERPNext documents?

Event-driven webhooks in ERPNext trigger on document lifecycle events like on_submit, on_update, or custom events. This Skill generates webhook senders for these Frappe document events, enabling integrations with external CRM systems, payment gateways, and third-party services automatically.