logo
開發者文件
搜尋
警報通知 (Alert Notification)

警報通知 (Alert Notification)

警報類型

image-20241226194156222

在 GPTBots 的「組織 - 警報通知」中,您可以體驗警報相關功能。
GPTBots 的警報通知功能依不同業務場景分為三種類型:

  • 額度警報:與點數和訂閱方案相關的提醒,包括:點數餘額提醒、點數消耗提醒、訂閱方案提醒。
  • 代理人警報:與代理人業務場景相關的提醒,包括:代理人對話 RPM 限制超出提醒、代理人對話 RPM 限制觸發次數提醒、代理人對話異常回覆次數限制超出提醒。
  • 問題分類提醒:與代理人互動過程中問題分類頻率相關的提醒場景。

警報規則設定

警報項目

image-20241226194534946

選擇警報類型後,點選該類型下的「新增提醒」開始設定警報。

設定警報時,需選擇具體的警報項目,例如:點數餘額。
請注意,在業務提醒中,需選擇目標代理人;在分類提醒中,需同時選擇目標代理人與目標問題分類。

警報規則

警報規則為觸發警報的條件,當條件達成時即會觸發提醒。

通知頻次

通知頻次決定提醒的發送頻率。當警報被觸發後,使用者可自行設定通知頻次。

通知方式

image-20241226194739578

GPTBots 支援四種通知方式:電子郵件、簡訊、WhatsApp(跨平台即時通訊應用程式)和 Webhook(網路回呼)。您可選擇通知方式並新增成員。當警報被觸發時,GPTBots 會根據選擇的方式及成員聯絡資訊發送通知。

警報 Webhook(網路回呼)配置

此 Webhook 用於接收警報通知。透過 POST 請求,客戶端可將警報資訊(包含警報標題、時間、內容)發送至指定的 Webhook URL。
請求 URL

  • URL:動態配置的 Webhook URL
  • 方法:POST
  • Content-Type:application/json
    請求標頭
    Username: webhookClientId
    Secret: webhookClientSecret
    標頭 必填 描述
    Content-Type 請求主體的內容格式,固定為 application/json
    Authorization 若同時配置 webhookClientIdwebhookClientSecret,則需此標頭。
    授權說明
  • 若同時存在 webhookClientIdwebhookClientSecret,則採用 Basic 認證(基礎身份驗證),格式如下:
Authorization: Basic Base64(clientId:clientSecret)
                      
                      Authorization: Basic Base64(clientId:clientSecret)

                    
此代碼塊在浮窗中顯示
  • 若僅存在 webhookClientId,則採用 Bearer 認證(持票人身份驗證),格式如下:
Authorization: Bearer clientId
                      
                      Authorization: Bearer clientId

                    
此代碼塊在浮窗中顯示
  • 若僅存在 webhookClientSecret,則採用 Bearer 認證(持票人身份驗證),格式如下:
Authorization: Bearer clientSecret
                      
                      Authorization: Bearer clientSecret

                    
此代碼塊在浮窗中顯示

請求主體
請求主體為 JSON 格式,包含以下欄位:

欄位 類型 必填 說明
title String 警報標題
time Long 警報時間戳(毫秒)
content String 警報具體內容
範例:
{ "title": "CPU 使用率警報", "time": 1698745600000, "content": "CPU 使用率在過去 5 分鐘內超過了 90%。" }
                      
                      {
  "title": "CPU 使用率警報",
  "time": 1698745600000,
  "content": "CPU 使用率在過去 5 分鐘內超過了 90%。"
}

                    
此代碼塊在浮窗中顯示

注意事項

  1. Webhook URL 驗證:URL 必須為有效的外部位址,不可指向內部 IP 位址(如 192.168.x.x 或 10.x.x.x)。
  2. 認證:如有設定 webhookClientIdwebhookClientSecret,請依上述方式進行身份驗證。
  3. 逾時設定:預設請求逾時為 5 秒,若目標伺服器 5 秒內未回應,請求將失敗。

提醒頻率管理

image-20241226194848985

在「提醒頻率管理」中,您可設定不同通知方式的提醒總量,並自訂提醒通知的語言。