🪝 웹후크 통합

개요

Open WebUI는 새 사용자가 인스턴스에 가입할 때마다 자동으로 알림을 받을 수 있는 웹후크 기능을 제공합니다. 이는 Open WebUI에 웹후크 URL을 제공하면, 새 사용자 계정이 생성될 때 해당 URL로 알림을 보내는 방식으로 이루어집니다.

Open WebUI에서 웹후크 구성

웹후크를 지원하는 외부 서비스(예: Discord 채널 또는 Slack 워크스페이스)에서 웹후크 URL을 확보해야 합니다. 이 URL은 Open WebUI의 알림을 수신하는데 사용됩니다.

Open WebUI에서 웹후크를 구성하는 방법은 두 가지가 있습니다:

옵션 1: 관리자 인터페이스를 통해 구성

1. 관리자 계정으로 Open WebUI 인스턴스에 로그인합니다.
2. 관리자 패널로 이동합니다.
3. 상단에 위치한 설정 탭을 클릭합니다.
4. 관리자 패널의 설정 일반 섹션으로 이동합니다.
5. Webhook URL 필드를 찾아 웹후크 URL을 입력합니다.
6. 변경 사항을 저장합니다.

옵션 2: 환경 변수로 구성

또한, 환경 변수 WEBHOOK_URL을 설정하여 웹후크 URL을 구성할 수 있습니다. Open WebUI에서 환경 변수에 대한 자세한 내용은 환경 변수 설정을 참조하세요.

3단계: 웹후크 확인

웹후크가 올바르게 작동하는지 확인하려면 Open WebUI에서 새 사용자 계정을 생성하세요. 웹후크가 올바르게 구성되었으면 지정된 웹후크 URL에 알림이 전송됩니다.

웹후크 페이로드 형식

Open WebUI에서 보내는 웹후크 페이로드는 단순한 알림 메시지로 구성된 평문 텍스트입니다. 새 사용자 계정에 대한 알림 메시지는 다음 형식을 따릅니다:

새 사용자 가입: <username>

예를 들어, "Tim"이라는 사용자가 가입하면 전송되는 페이로드는 다음과 같습니다:

새 사용자 가입: Tim

문제 해결

• 웹후크 URL이 올바르고 정확하게 작성되었는지 확인하세요.
• 웹후크 서비스가 활성화되고 올바르게 구성되었는지 확인하세요.
• Open WebUI 로그에서 웹후크와 관련된 오류를 확인하세요.
• 방화벽 또는 프록시에 의해 연결이 차단되거나 중단되지 않았는지 확인하세요.
• 웹후크 서버가 일시적으로 사용 불가능하거나 높은 지연시간을 경험할 수 있습니다.
• 웹후크 서비스에서 제공한 경우, 웹후크 API 키가 잘못되었거나 만료되었거나 취소되지 않았는지 확인하세요.

참고: Open WebUI의 웹후크 기능은 아직 진화 중이며 향후 더 많은 기능과 이벤트 유형이 추가될 예정입니다.