> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# superun SMS Provider

> 使用 superun 雲計算 整合 SMS 手機驗證 - 自動配置並可直接使用

# superun SMS Provider

本指南說明如何使用 superun 雲計算 整合 SMS 手機驗證.當 superun 雲計算 運行時,手機登入會自動啟用,所有必要的驗證鉤子配置都會自動處理.

## 概述

superun 雲計算 自動處理 SMS 驗證設置:

* **自動啟用手機登入**:當 superun 雲計算 啟動時,手機驗證會自動啟用
* **預配置驗證鉤子**:`send_sms` 鉤子會自動配置並連接到 superun Gateway
* **無需手動配置**:您不需要手動創建 Edge Functions 或配置驗證鉤子
* **可直接使用**:只需在應用程式中整合客戶端驗證流程

## 客戶端整合

在客戶端應用程式中整合 SMS 驗證流程.這是用戶互動的前端整合邏輯:

```typescript theme={null}
import { supabase } from "@/integrations/supabase/client";

// 透過 SMS 發送 OTP - 當用戶點擊「發送驗證碼」時調用此函數
async function sendOTP(phone: string) {
  const { data, error } = await supabase.auth.signInWithOtp({
    phone: phone,
  });

  if (error) {
    throw new Error(error.message);
  }

  return data;
}

// 驗證 OTP - 當用戶點擊「登入」或「驗證」時調用此函數
async function verifyOTP(phone: string, token: string) {
  const { data, error } = await supabase.auth.verifyOtp({
    phone: phone,
    token: token,
    type: "sms",
  });

  if (error) {
    throw new Error(error.message);
  }

  return data;
}
```

**使用流程:**

1. **用戶點擊「發送驗證碼」**:調用 `sendOTP(phone)` 觸發 SMS 發送.superun 雲計算 會透過預配置的驗證鉤子自動處理 SMS 發送.
2. **用戶輸入驗證碼並點擊「登入」**:調用 `verifyOTP(phone, token)` 驗證代碼並完成驗證.

## 運作方式

1. **用戶發起 SMS 驗證**:當用戶透過 `signInWithOtp()` 請求手機驗證時,Supabase 會生成一個 OTP
2. **驗證鉤子自動觸發**:superun 雲計算 預配置的 `send_sms` 鉤子會攔截驗證事件
3. **自動發送 SMS**:鉤子會使用 superun Gateway 發送 SMS 驗證碼
4. **用戶驗證代碼**:用戶輸入代碼,`verifyOtp()` 完成驗證流程

<Note>
  所有後端基礎設施（Edge Functions,驗證鉤子配置,webhook 驗證和 SMS 閘道整合）都由 superun 雲計算 自動處理.您只需要實作上述的客戶端驗證流程.
</Note>