認證狀態
SDK 提供 authState prop,針對認證流程的每個階段渲染對應的 UI。
搭配 onApiKeySubmit 可以做非同步的 API key 驗證。
認證狀態
聊天機器人載入中…
支援的狀態
| 狀態 | UI 行為 |
|---|---|
authenticated | 正常聊天介面 |
needApiKey | 提示使用者輸入 API key |
invalidApiKey | 錯誤狀態加上重試提示 |
loading | 認證判斷中,顯示 spinner |
error | 一般錯誤 UI |
subscriptionExpired | 訂閱到期,顯示升級 CTA |
botNotFound | bot provider 回傳 404 時的封鎖畫面 |
程式範例
const [authState, setAuthState] = useState<AuthState>("needApiKey");
<Chatbot
authState={authState}
onApiKeySubmit={async (key) => {
const valid = await validate(key);
setAuthState(valid ? "authenticated" : "invalidApiKey");
}}
{...rest}
/>;