Webhook Sender Plugin

Author: gaurav0651
Version: 1.0.0
Type: Tool Plugin

Description

The Webhook Sender plugin allows you to send workflow data to external webhook endpoints as HTTP requests. This powerful tool enables integration between your Dify workflows and external services, APIs, or systems that accept webhook notifications.

Features

• ✅ Multiple HTTP Methods: Supports POST, PUT, and PATCH requests
• ✅ Custom Headers: Add authentication tokens, API keys, or custom headers
• ✅ Comprehensive Payload: Sends complete workflow context including input data
• ✅ Flexible Configuration: Configurable timeout and request parameters
• ✅ Error Handling: Detailed error messages and status reporting
• ✅ Real-time Feedback: Shows request/response details for debugging

Use Cases

• Workflow Integration: Connect Dify workflows to external systems
• Data Synchronization: Send processed data to databases or APIs
• Notifications: Trigger alerts or notifications in external services
• Automation: Chain workflows with external automation tools
• Logging: Send workflow results to logging or monitoring systems

Configuration

Required Parameters

• Text Input: The main content to send in the webhook payload
• Webhook URL: The target endpoint URL to send the request to

Optional Parameters

• HTTP Method: Choose between POST (default), PUT, or PATCH
• Custom Headers: JSON object with additional headers (e.g., authentication)
• Timeout: Request timeout in seconds (default: 30)

Example Configuration

Custom Headers (JSON):

Payload Structure

The webhook will receive a JSON payload with the following structure:

Payload Fields

• : The main text input from your workflow
• : Always "dify_workflow" to identify the source
• : ISO timestamp of when the webhook was sent

Installation

1. Download the webhook sender plugin
2. Install in your Dify instance
3. Add the "Webhook Sender" tool to your workflow
4. Configure the webhook URL and parameters
5. Connect it to your workflow nodes

Error Handling

The plugin provides detailed error messages for common issues:

• Connection errors: When the webhook URL is unreachable
• Timeout errors: When requests take longer than the specified timeout
• HTTP errors: When the webhook returns error status codes (400+)
• Configuration errors: When required parameters are missing or invalid

Security Considerations

• Always use HTTPS URLs for sensitive data
• Store API keys and tokens securely using the Custom Headers field
• Validate webhook URLs before deployment
• Monitor webhook responses for security issues

Support

For issues, feature requests, or contributions:

• GitHub: https://github.com/gaurav0651/dify_webhook_sender
• Report bugs through GitHub Issues
• Submit feature requests or improvements

Changelog

Version 1.0.0

• Initial release
• Support for POST, PUT, PATCH methods
• Custom headers support
• Comprehensive payload structure
• Error handling and timeout configuration
• Multi-language support (EN, ZH, PT, JA)

License

This plugin is open source and available under the MIT License.