OpenWebUI/docs
1
0
Fork 0
mirror of https://github.com/open-webui/docs synced 2025-05-20 11:18:42 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Merge pull request #320 from silentoplayz/silentoplayz-webhooks

Browse Source 
New Webhooks docs page
This commit is contained in:
silentoplayz 2024-12-17 15:09:29 -05:00 committed by GitHub
commit 1e1faa846b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 60 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
docs/features/webhooks.md Normal file
View File

@ -0,0 +1,60 @@
---
sidebar_position: 10
title: "🪝 Webhook for New Sign Ups"
---
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: <username>
```
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.
Note: The webhook feature in Open WebUI is still evolving, and we plan to add more features and event types in the future.