From 770b9263fa3404a9910f5313c70a040ad68b4661 Mon Sep 17 00:00:00 2001 From: silentoplayz <50341825+silentoplayz@users.noreply.github.com> Date: Tue, 17 Dec 2024 12:59:42 -0500 Subject: [PATCH 1/3] Add files via upload New Webhooks docs page --- docs/features/webhooks.md | 81 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 docs/features/webhooks.md diff --git a/docs/features/webhooks.md b/docs/features/webhooks.md new file mode 100644 index 0000000..88b7efb --- /dev/null +++ b/docs/features/webhooks.md @@ -0,0 +1,81 @@ +--- +sidebar_position: 10 +title: "🪝 Webhooks in Open WebUI" +--- + +Overview +-------- + +Open WebUI provides a webhook feature that allows you to receive notifications automatically whenever new users sign up to your instance. This is done by providing a webhook URL to Open WebUI, which will then send notifications to that URL when a new user account is created. + +Configuring Webhooks in Open WebUI +--------------------------------- + +You will need to obtain a webhook URL from an external service that supports webhooks, such as a Discord channel or a Slack workspace. This URL will be used to receive notifications from Open WebUI. + +To configure webhooks in Open WebUI, you have two options: + +### Option 1: Configure through the Admin Interface + +1. Log in to your Open WebUI instance as an administrator. +2. Navigate to the `Admin Panel`. +3. Click the `Settings` tab located at the top. +4. From there, navigate to the `General` sectionn of the setting in the admin panel. +5. Locate the `Webhook URL` field and enter the webhook URL. +6. Save the changes. + +### Option 2: Configure through Environment Variables + +Alternatively, you can configure the webhook URL by setting the `WEBHOOK_URL` environment variable. For more information on environment variables in Open WebUI, see [Environment Variable Configuration](https://docs.openwebui.com/getting-started/advanced-topics/env-configuration/#webhook_url). + +### Step 3: Verify the Webhook + +To verify that the webhook is working correctly, create a new user account in Open WebUI. If the webhook is configured correctly, you should receive a notification at the specified webhook URL. + +Webhook Payload Format +---------------------- + +The webhook payload sent by Open WebUI is in plain text and contains a simple notification message about the new user account. The payload format is as follows: + +``` +New user signed up: +``` + +For example, if a user named "Tim" signs up, the payload sent would be: + +``` +New user signed up: Tim +``` + +Troubleshooting +-------------- + +* Make sure the webhook URL is correct and properly formatted. +* Verify that the webhook service is enabled and configured correctly. +* Check the Open WebUI logs for any errors related to the webhook. +* Verify the connection hasn't been interrupted or blocked by a firewall or proxy. +* The webhook server could be temporarily unavailable or experiencing high latency. +* If provided through the webhook service, verify if the Webhook API key is invalid, expired, or revoked. + +FAQ +--- + +* Q: Is it possible to set a Discord webhook URL at "webhook URL"? + + A: Yes, you can set a Discord webhook URL at the "webhook URL" field in the Open WebUI admin settings. + +* Q: What is the purpose of the webhook feature in Open WebUI? + + A: The webhook feature allows you to receive notifications automatically whenever new users sign up to your Open WebUI instance. It is intended to provide a way to setup telemetry and integrate with external services. + +* Q: Can I use the webhook feature to receive notifications for other events besides new user sign-ups? + + A: Currently, the webhook feature in Open WebUI is only used for new user account notifications. However, we plan to add more event types in the future. + +Limitations +------------ + +* Currently, webhooks in Open WebUI are only used for new user account notifications. +* Additional webhook events and payload formats may be added in future versions of Open WebUI. + +Note: The webhook feature in Open WebUI is still evolving, and we plan to add more features and event types in the future. From 02717c67d25b4b2f2a9a2960cf422ebc6a5a3d0b Mon Sep 17 00:00:00 2001 From: silentoplayz <50341825+silentoplayz@users.noreply.github.com> Date: Tue, 17 Dec 2024 13:06:02 -0500 Subject: [PATCH 2/3] Update webhooks.md Removed redundancy --- docs/features/webhooks.md | 21 --------------------- 1 file changed, 21 deletions(-) diff --git a/docs/features/webhooks.md b/docs/features/webhooks.md index 88b7efb..7312656 100644 --- a/docs/features/webhooks.md +++ b/docs/features/webhooks.md @@ -57,25 +57,4 @@ Troubleshooting * The webhook server could be temporarily unavailable or experiencing high latency. * If provided through the webhook service, verify if the Webhook API key is invalid, expired, or revoked. -FAQ ---- - -* Q: Is it possible to set a Discord webhook URL at "webhook URL"? - - A: Yes, you can set a Discord webhook URL at the "webhook URL" field in the Open WebUI admin settings. - -* Q: What is the purpose of the webhook feature in Open WebUI? - - A: The webhook feature allows you to receive notifications automatically whenever new users sign up to your Open WebUI instance. It is intended to provide a way to setup telemetry and integrate with external services. - -* Q: Can I use the webhook feature to receive notifications for other events besides new user sign-ups? - - A: Currently, the webhook feature in Open WebUI is only used for new user account notifications. However, we plan to add more event types in the future. - -Limitations ------------- - -* Currently, webhooks in Open WebUI are only used for new user account notifications. -* Additional webhook events and payload formats may be added in future versions of Open WebUI. - Note: The webhook feature in Open WebUI is still evolving, and we plan to add more features and event types in the future. From e290ce40fb9f4e5020f61e039c4ce1d311443bec Mon Sep 17 00:00:00 2001 From: silentoplayz <50341825+silentoplayz@users.noreply.github.com> Date: Tue, 17 Dec 2024 13:59:47 -0500 Subject: [PATCH 3/3] Update webhooks.md --- docs/features/webhooks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/features/webhooks.md b/docs/features/webhooks.md index 7312656..50b1084 100644 --- a/docs/features/webhooks.md +++ b/docs/features/webhooks.md @@ -1,6 +1,6 @@ --- sidebar_position: 10 -title: "🪝 Webhooks in Open WebUI" +title: "🪝 Webhook for New Sign Ups" --- Overview