借助 Airtable 搭建一個團隊共享的臨時號碼狀態看板

一個在團隊內部工具分享會上做演示的 QA 自動化架構師的實戰教學——每一步都有設計理由，每一列都有思考，每一個坑都提前替你踩平了。

一、完整的協作架構圖

整個方案圍繞「單一事實來源」原則設計——Airtable 是唯一的真相，所有人看到的是同一份數據。

• 接碼平台：號碼來源，提供短信事件和號碼狀態。
• 同步腳本：負責輪詢 API、清洗格式、查重後寫入 Airtable。
• Airtable Base：共享的「單一事實來源」，團隊成員透過瀏覽器或 App 同時查看和編輯。

二、Step 1：設計 Airtable 表格結構（全文核心地基）

表格結構是整個看板的靈魂。以下欄位設計經過三個 QA 團隊的實戰打磨，每一列都有明確的設計理由。

欄位名稱	欄位類型	示例值	設計理由
號碼	Phone	+1(234)567-8901	唯一標識，可點擊直接撥打（Airtable Phone 類型支援一鍵呼叫）
號碼狀態	Single Select	🟢可用 / 🟡使用中 / 🔴已失效	核心狀態列，一眼看全局。用顏色 Emoji 讓狀態在手機 App 上也清晰可辨
接碼平台	Single Select	5sim / SMSPool / SMS-MAN	追溯來源，方便比對不同平台的號碼品質
所用服務	Multiple Select	Google / Telegram / WhatsApp	記錄該號碼在哪些服務可用——這是團隊的「知識資產」，新人接手無需重新測試
最後驗證時間	Date	2026-04-29 14:23	自動判斷是否過期，超過 3 天未驗證的號碼需重新確認可用性
持有者	User	@張三	誰正在使用此號碼——避免兩人同時用同一個號碼觸發驗證碼
備註	Long Text	收 Telegram 驗證碼成功，50 秒延遲	自由補充資訊，如延遲時間、特殊注意事項

建立表格的實操步驟：在 Airtable 中新建 Base → 命名為「團隊號碼庫」→ 依上表逐欄新增欄位 → 設定 Single Select 的選項為🟢可用、🟡使用中、🔴已失效 → 設定 Multiple Select 的選項為常用服務（Google、Telegram、WhatsApp、TikTok、Amazon 等）。

三、Step 2：構建雙核心視圖——不同角色的視角切換

同一個 Base，兩個人打開看到的內容不同——這就是 Airtable 視圖的威力。以下兩種視圖覆蓋了 QA 測試和管理員兩種核心角色。

視圖一：QA 測試看板（Grid View）

這個視圖讓測試人員只看到「能用的號碼」，排除一切已失效的干擾。

配置項	設定值	理由
分組	按「號碼狀態」分組	可用/使用中/已失效三個區塊一目了然
篩選	僅顯示狀態為「🟢可用」和「🟡使用中」	已失效的號碼不出現在測試視圖中，減少干擾
排序	按「最後驗證時間」降序	最新驗證過的號碼排在最前面——越新鮮越可靠
隱藏欄位	隱藏「接碼平台」欄	測試人員不需要關心號碼來源，減少資訊過載

視圖二：管理員健康度看板（Grid View）

這個視圖讓管理員快速定位「哪些號碼需要重新驗證」，主動發現問題而非被動等待報告。

首先新增一個公式欄位「需驗證提醒」：

IF(
  DATETIME_DIFF(TODAY(), {最後驗證時間}, 'days') > 3,
  "⚠️ 需驗證",
  ""
)

這個公式自動標記超過 3 天未驗證的號碼。然後配置視圖：

配置項	設定值	理由
篩選	顯示所有狀態 + 公式欄位「需驗證提醒」不為空	只顯示需要關注的號碼
排序	按「最後驗證時間」升序	最久未驗證的排最前——優先處理
顏色規則	「需驗證提醒」欄位包含「⚠️」時整行設為淡黃色背景	視覺上快速掃描問題號碼

四、Step 3：編寫自動同步腳本——輪詢接碼平台並寫入 Airtable

以下 Python 腳本（約 50 行）負責從接碼平台拉取最新短信記錄，查重後寫入 Airtable，並更新已有號碼的狀態。使用 pip install pyairtable requests 安裝依賴。

import os, time, re
from pyairtable import Api as AirtableApi
import requests

AIRTABLE_API_KEY = os.getenv('AIRTABLE_API_KEY')
AIRTABLE_BASE_ID = os.getenv('AIRTABLE_BASE_ID')
AIRTABLE_TABLE_NAME = os.getenv('AIRTABLE_TABLE_NAME', '號碼庫')
FIVESIM_API_KEY = os.getenv('FIVESIM_API_KEY')

airtable = AirtableApi(AIRTABLE_API_KEY).table(AIRTABLE_BASE_ID, AIRTABLE_TABLE_NAME)

def get_recent_sms_from_5sim():
    """從 5sim 獲取最近的短信記錄"""
    resp = requests.get('https://5sim.net/v1/user/orders',
        headers={'Authorization': f'Bearer {FIVESIM_API_KEY}', 'Accept': 'application/json'})
    if resp.status_code != 200:
        return []
    orders = resp.json().get('orders', [])
    records = []
    for order in orders:
        if order.get('status') == 'RECEIVED':
            for sms in order.get('sms', []):
                records.append({
                    'phone': order.get('phone'),
                    'sms_text': sms.get('text', ''),
                    'platform': '5sim',
                    'received_at': sms.get('created_at', '')
                })
    return records

def format_phone(raw_phone):
    """清洗號碼為 E.164 格式"""
    cleaned = re.sub(r'[^\d+]', '', raw_phone)
    if not cleaned.startswith('+'):
        cleaned = '+' + cleaned
    return cleaned

def sync_to_airtable():
    """查重後寫入或更新 Airtable"""
    sms_records = get_recent_sms_from_5sim()
    for record in sms_records:
        phone = format_phone(record['phone'])
        # 查重：用號碼欄位做唯一索引
        existing = airtable.all(formula=f"{{號碼}}='{phone}'")
        if existing:
            # 已存在：只更新狀態和時間
            airtable.update(existing[0]['id'], {
                '號碼狀態': '🟢可用',
                '最後驗證時間': record['received_at'][:10],
                '備註': f"最新短信: {record['sms_text'][:50]}"
            })
        else:
            # 新號碼：插入一筆記錄
            airtable.create({
                '號碼': phone,
                '號碼狀態': '🟢可用',
                '接碼平台': record['platform'],
                '最後驗證時間': record['received_at'][:10],
                '備註': f"初始短信: {record['sms_text'][:50]}"
            })
        time.sleep(0.3)  # 避免觸發 API 頻率限制
    print(f'✅ 同步完成：{len(sms_records)} 條記錄')

if __name__ == '__main__':
    sync_to_airtable()

設定定時執行（crontab）

每 5 分鐘自動同步一次，確保看板始終反映最新狀態：

*/5 * * * * cd /opt/sms-airtable && python3 sync.py >> /var/log/sms_sync.log 2>&1

也可使用 systemd timer 或 GitHub Actions 的 schedule 觸發器實現同等效果。

五、進階玩法：讓看板「活」起來

六、排坑指南

---

結語：從「誰有能用的號」到「打開看板自己看」的團隊協作升級

這套方案為 QA 團隊帶來的三重價值：

• 號碼狀態透明化——所有人看到同一份數據，衝突歸零。不再有人喊「這個號碼誰在用」。
• 知識資產化——每個號碼的「可用服務清單」自動積累，新人接手無需重新測試。號碼庫使用三週後，你就擁有了一份專屬於你團隊的號碼品質數據。
• 工作流無感化——同步腳本每 5 分鐘跑一次，看板始終保活。團隊成員只需打開 Airtable 就知道該用哪個號碼，無需切換到接碼平台。