ContactLoop

內部上手指南 · 請先登入

沒有密碼?請向管理員索取。

從 0 開始 · 路線 A

從 Ava 建帳號到 SW Segment 設定完成

這條路線是一條跨系統的完整流程:先在 Ava Messenger 建立一個新的 Account,再到 SW Manager 用它的 Account ID 接上、匯入名單、把 Segment 設到好。全程以 stg 環境為例,不碰任何程式碼。

🔑

整條流程的「橋」是 Ava Account ID(填進 SW App Integration 的 Account ID 欄位;stg 環境還要記得勾 Sandbox)。Ava 端建帳號時產生,SW 端 App Integration 消費。所以必須先做 Ava、再做 SW,順序不能反。

Phase 1 · Ava 端 — 建立帳號、Bot、Campaign

  1. 取得 Ava 登入帳號(signup 目前是 stub)

    ⚠️ 注意:/auth/signup 頁面目前是 stub——填 Nickname/Email/Password 送出後只會跳「Account created. Please check your inbox!」提示,不會呼叫任何 API、不寄確認信、也不會真的建帳號。所以登入帳號請改由已存在的 system-admin 建立再提供給你。stg 環境大多數 user 拿到的都是 system-admin 權限,可直接用來跑後續流程。這一步建立的是「登入使用者」,還不是業務 Account(業務 Account 在下面「建立新的 Ava Account」步驟建)。

  2. 登入 Ava Messenger

    確認信完成後到 /auth/signin 用 Email + Password 登入,進入 Ava 主畫面。stg / cl1 / prod 是三套獨立的 Ava,帳號不互通。

  3. 綁定 Google(建立 Account 的前提)

    ⚠️ 沒綁 Google 就建不了 Account,就算是 system-admin 也一樣。沒綁的話,Account 列表的 Create 按鈕和上方帳號選單的 Create New Account 都是灰的,滑過去會提示「Please link to google first.」。
    綁定方式(任選一個):
    ・右上角使用者選單 → Profile → Google 那列按 Link → 完成 Google 授權 → 回來顯示 Linked。
    ・上方帳號選單底部,灰色按鈕下的提示「…Please click here to link to google first.」,點 here。
    綁好後按鈕就能按了。一個 Google 帳號只能綁一個使用者;如果出現「Please link to google email which is not linked to this account yet…」,代表這個 Google 帳號已經綁在別的使用者身上,要換一個。
    為什麼要綁:建立 Account 的人會成為它的 Account Owner,之後這個 Account 建立 Dialogflow 類型的 Bot 時,會用 Owner 綁定的 Google 授權在 Google 雲端開專案。詳見 Ava 介面導覽 → 使用者選單。

  4. 建立新的 Ava Account

    從 admin 進入 Account 列表(/accounts)後,點右上角 Create 建立新 Account。必填:Name(帳號名)、Transfer Phone Number(轉接號碼,預設走 Dial Transfer,之後可在 Settings 改 Streaming Transfer)、Organization(所屬組織,下拉選)。

    Ava Create New Account 表單 img/AVA1.png
    Create New Account 表單

    ⚠️ Inherit Existed Twilio Account 欄位請務必依照A2P 詳解裡「各環境要 Inherit 哪個帳號」的對照表填(stg / prod / cl1 各不同)——若這裡沒設定,新 Account 會沒有 A2P 資格,之後無法發送任何 SMS 或撥打電話。
    🔒 權限:/accounts 屬於 Admin 群組(roles: [] = 僅 system-admin),Cascader 的「Create New Account」也需要 ACCOUNT_CREATE 權限——所以這一步必須用 system-admin 帳號,而且要已經綁好 Google(上一步)。stg 環境大多數 user 都是 system-admin,可直接做;若你不是,請找 system-admin 協助建 Account。
    建立完成後刷新頁面,再進入剛建立的 Account 做接下來的設定。💡 小提示:在 Account 列表找剛建立的那筆,可以點 ID 欄排序,最新建立的會排到最上面(或最下面,依排序方向)。

  5. 建立 Bot(Campaign 的必要前提)

    ⚠️ 要先建立 Bot,否則無法建立 Campaign。一樣點右上角 Create 建立新 Bot(/accounts/{accountId}/bots/create)。

    Ava Create Bot 表單 img/AVA2.png
    Create Bot 表單

    Name:Bot 名稱。

    Type 選 Fusion KB(另一個選項 DialogFlow 需要 user 先跟 Google 連通帳號,暫時不用管)。

    Welcome Message——這則訊息只有在 Ava → Bots → Chat Simulator 測試時會出現,平常用實體號碼測試不會看到它,屬正常現象,不是沒設定成功。表單現在支援用「+ Add Welcome Message」新增多筆訊息(Form.List),不再只有單一欄位。

    Reply Mode 由上到下是 Fixed(死板)→ Guided → Flexible(靈活)。⚠️ 這其實是兩層設定:General 區塊裡「Unknown Intent Response」搭配的 Reply Mode 只管 AI 聽不懂時怎麼回;獨立的「Reply Mode」collapse 區塊才是這裡講的整體 Reply Mode。兩者都可能在 Campaign 層或 Account 層被覆蓋,優先序是 Campaign Intent Level > Account Intent Level > Bot Level——在這裡設的只是最底層的預設值。

    Intent Group 一開始可以先選前面有 - 前綴的四個(用 Transfer 元件從 Available 移到 My Intent Groups),之後有需求再自行新增。

  6. 建立 Campaign

    Bot 建好後,一樣點右上角 Create 建立新 Campaign。精靈只需要填 Name,其他步驟(Default Language、Default Timezone、後續的 IVR/Conversation 設定)都有預設值,一路按 Continue 到底即可——這些之後都能回 Campaign Settings 再調整。

  7. 確認 Account ID 與 Campaign ID 都已記錄

    以上是 Ava 建立新 Account 的完整步驟。收尾前務必確認沒有遺漏:Account ID(Account 列表 Name (ID: nn))和 Campaign ID(Campaign 列表同樣格式)都要存在、記錄下來——接下來 SW 那邊(Phase 2)的 Asset / Integration 都會用到。

Phase 2 · SW 端 — 建 Account、接上 Ava、完成 Segment

  1. 登入 SW Manager 並建立新 Account

    開 https://staging.sw.onramplab.com/auth/signin,輸入 SW 的 Email + 密碼登入(看到 "home" 字樣即成功)。從 settings/admin 進入 Accounts 列表,點右上角 Create 建立新 Account。

    SW Create Account 表單 img/SW1.png
    Create Account 表單

    表單裡兩個欄位要特別注意:
    ⚠️ Phone Verification 開啟的話,非美國的正式號碼會被阻擋並加入黑名單——如果客戶名單有海外門號,先確認這個開關的影響。
    ⚠️ Blacklist Check Enabled 開啟的話,匯入時會檢查號碼是否在一些已知黑名單裡。
    💡 Redirect Domain 先跟著外面其他 Account 填一樣的值就好,不用自己另外想。

  2. 把新 Account 加入 Organization,再把 Organization 指給你的 User

    ⚠️ 建立完 Account 後,即使刷新頁面,也沒辦法在帳號切換器上馬上看到剛建立的 Account——這不是壞掉,是因為新 Account 還沒被指派給任何人。要讓自己的 User 看得到它,需要兩步:
    ① 進 admin → Organization,把剛建的 Account 加入一個 Organization(attachAccounts,只能選還沒被任何 Organization 綁定的自由帳號)。
    ② 進 admin → Users,編輯你自己的 User,在 Organizations多選欄裡把該 Organization 加進去——User 會 inherit 這個 Organization 底下所有 Account(唯讀顯示在下方確認)。

    Organization 內加入 Account img/SW2.png
    admin → Organization:Add Account
    User 內指派 Organization img/SW3.png
    admin → Users:把 Organization 指給 User
  3. 切換到新 Account,建立 App Integration(接 Ava)

    點左上角 logo 離開 admin 頁面,用帳號切換器切到剛新增的 Account。點 settings/admin 進入 /app-integrations,一樣點右上角 Create 建立新的 App Integration。

    Create App Integration 表單 img/SW4.png
    Create App Integration 表單

    Type 選 Ava。這個表單只有兩個欄位:Account ID——這裡填的其實是 Phase 1 拿到的 Ava Account ID(目前實作把它存進後端叫 api_key 的欄位,是暫時的技術債,不代表要另外填一組 API Key);Sandbox checkbox——在 stg 環境一定要勾選 Sandbox,才能連到 Ava。沒設這一步,後續 Action 呼叫 Ava 不會生效。

  4. 到 Configuration 建立 Asset

    建好 App Integration 後,到左側選單的 Configuration 群組建立 Asset——⚠️ 每個 App Integration 有自己的子項目,要在剛建立的那個 App Integration 名稱底下建 Asset,別選錯了。一樣點右上角 Create。

    Create Asset 表單 img/SW5.png
    Create Asset 表單

    先確認 App Integration 名稱是不是選對了那個 Ava 整合,再選 Interaction Type(目前 Ava 只有兩種:Message / Call)、選 Campaign。如果 Interaction Type 選 Message,需要填 Template 作為 Ava 要傳送的訊息內容;選 Call 則不用填。

  5. 到 Configuration 建立 Segment

    一樣在 Configuration 裡,點右上角 Create 建立新 Segment。

    Create Segment 表單 img/SW6.png
    Create Segment 表單

    表單上半部的 Rules(資料篩選)是觸發條件設定——決定哪些聯絡人算命中這個 Segment。下半部從 Reschedule Rule 開始一路到底的欄位(Type、Business Hours、TCPA、Holiday 等)是觸發時間設定——決定命中的聯絡人「什麼時候」被真正觸發。存檔後頁面會直接接著要求你設定 Action。

  6. 設定 Action(選 Channel,可行內建立 Asset)

    Action 頁面設定 Channel 與 Asset img/SW7.png
    Action:Channel + Asset 選擇

    Channel 要跟剛剛建立的 Asset 對應:
    · 若 Asset 是 Message → Channel 選 SMS。
    · 若 Asset 是 Call → Channel 選 Active Dials。
    · Other 是給非 Ava 在用的其他整合類型選的,這條路線用不到。
    💡 如果前面沒有先建好 Asset,也可以在這個畫面直接建立:先選好 Channel 和要建在哪個 App Integration 底下,再點下面的 Create Asset 按鈕,彈出的表單就是完整的 Asset 建立流程。⚠️ 這個行內表單目前把 App Integration / Interaction Type 鎖成唯讀(顯示「Inherited from Action」),直接繼承 Action 已選的 Channel,不能在這裡改;要編輯這兩欄請改走 Configuration → Assets → Create 獨立路徑。
    ⚠️ 關鍵:在下拉選單裡選好要用的模板(Asset)後,一定要點旁邊的 Add 按鈕——不點 Add,選擇不會生效,Action 就等於沒接上任何 Asset。
    💡 若這個帳號底下有不只一個 Ava App Integration,這裡要手動選要用哪一個;如果帳號完全沒有 Ava 整合,會看到提示「No Ava integration found for this account. Set one up under App Integrations to use SMS / Active Dials.」,回到上一步先建好。

  7. 匯入聯絡人(Contacts)

    Contacts 選單 → Import Contact(stg 新版會在新分頁開啟)。貼上 CSV,欄位:phone, first_name, last_name, email, external_lead_id, traffic_source。匯入後,命中 Segment 規則的聯絡人會觸發「已指派給該 Segment 的 Action」,Action 再透過 App Integration 呼叫 Ava 發送(首則訊息 / 外呼)。⚠️ 若 Action 沒建或沒指派給 Segment,匯入只會把聯絡人寫入 SW,不會觸發任何訊息——這是「匯入了卻沒動」最常見的原因。

  8. 查看 Contacts-27 聯絡人資料

    到 /contacts-27 開啟聯絡人總覽(新版 ag-grid,進頁會打 /api/contacts/grid,回應 data.rows / data.lastRow)。在這裡確認剛匯入的聯絡人是否出現、用欄位排序與篩選查看 phone / first_name / last_name / email 等欄位。2026-08 起前端已改打 grid API,舊的 size=500 列表行為已不適用;若要對照舊版,可看 /contacts(old,size=20)或 /contacts-2026(old,size=500),新人日常請以 Contacts-27 為準。

⚠️

先在 stg 跑完整條,確認對話真的接起來再碰 prod。prod 匯入真實名單會真的發 SMS / 打電話給客戶,且受 TCPA 限制與營業時間(Business Hours)管控,出錯無法回收。Ava Account 一旦建立會開出真實 Twilio 門號費用,練習請用 stg。

流程總覽(整條從頭到尾的一頁式總圖)

Ava 登入帳號(由 system-admin 建立;signup 是 stub)→ Ava signin
   │
   ▼
右上使用者選單 → Profile → Google → Link〔沒綁 Google 不能建 Account〕
   │
   ▼
Ava /accounts → Create New Account(Name + Transfer Phone + Organization)〔需 system-admin〕
   │  產生 Ava Account ID  ←── 整條流程的「橋」
   ▼
Ava 建 Bot(Campaign 必要前提)→ 建 Campaign
   │
   ▼
SW signin → 選 SW Account
   │
   ▼
SW /app-integrations → Type=Ava,Account ID 填 Ava Account ID,stg 勾選 Sandbox
   │
   ▼
SW /assets → 建 Asset(樣板 + 變數 + Ava Campaign = 發什麼)
   │
   ▼
SW /segments → 建 Segment(規則 = 對誰 + Trigger 何時)→「Next - Create Action」
   │
   ▼
SW 建 Action(Channel + App Integration + 選 Asset)→ 指派回 Segment(action_id)
   │
   ▼
SW Import Contacts(命中規則者 count +1 → 觸發【已指派給 Segment 的 Action】→ Ava 發訊息)
   │
   ▼
SW /contacts-27 → 查看聯絡人資料
   │
   ▼  Phase 3 · 回 Ava 確認訊息與行為執行
Ava Cascader 選 Account/Campaign → Conversations 看對話 + 首則訊息 + Bot 回話
   │
   ▼
Ava Stats(Call Performance / Conversion)→ 確認行為有執行 ✓ 完成

Phase 3 · 回 Ava 確認訊息與行為有執行

前面 Phase 2 在 SW 做的事,最終都要回 Ava 這一端驗證真的發生了。這是整條流程的收尾,也是判斷「有沒有接起來」的依據。

  1. 切回 Ava,選剛建的 Account / Campaign

    回到 Ava Messenger,用頂部 Cascader 選 Phase 1 建的 Account,再進入該 Account 下的 Campaign(SW 端 Asset 的 Campaign 下拉選的就是這個)。選了會 router.push('/') 進 Campaign Dashboard,左側選單同時切換成「情境 B · Campaign 內選單」。Back in Ava Messenger, use the top Cascader to pick the Account from Phase 1, then enter a Campaign under it (the same one the SW Asset's Campaign dropdown selected). Selecting does a router.push('/') into the Campaign Dashboard, and the left sidebar switches to the "Context B · in-campaign" menu.

  2. 到 Conversations 看對話是否出現

    左側 Conversations → /campaigns/{cid}/conversations。確認剛匯入的聯絡人有出現一則對話,且SW 觸發的首則訊息(Asset 的 Template 內容)已送達。若這個 Campaign 的 Settings → Bot tab 有綁 Bot,會看到 Ava 自動回話——這就是「Ava 行為有執行」最直接的證據。若 Bot 沒綁,只會看到單向的首則訊息(沒有自動應答),此時行為算「訊息送達但未應答」;詳見 Campaign Settings 詳解。Left sidebar Conversations → /campaigns/{cid}/conversations. Confirm each imported contact shows a conversation thread and that the first message triggered by SW (the Asset's Template content) was delivered. If this Campaign's Settings → Bot tab has a Bot attached, you'll see Ava auto-reply — the most direct evidence that "Ava behavior executed." With no Bot attached you'll only see the one-way first message (no auto-reply); in that case the status is "message delivered, not answered." See Campaign Settings detail.

  3. 到 Stats 確認行為有執行

    左側 Stats 群組:Call Performance Stats(所有角色可見)看發送/通話數;Conversion Stats(Owner/AccountAdmin)看轉換。計數 > 0 代表 Action 確實被觸發並送到 Ava 執行。也可回帳號層 Stats 看 Campaign Performance 當整體對照。Left sidebar Stats group: Call Performance Stats (all roles) for send/call counts; Conversion Stats (Owner/AccountAdmin) for conversions. A count > 0 means the Action was actually triggered and executed on the Ava side. You can also check account-level Stats → Campaign Performance for an overall comparison.

  4. 通過標準(什麼算「接起來了」)

    同時滿足以下即算成功:
    ① Contacts-27 看得到匯入的聯絡人(資料有進 SW);
    ② Ava Conversations 看得到對話 + 首則訊息已送達(訊息有到 Ava);
    ③ Ava Stats 計數 > 0(Action 確實被觸發執行);
    ④ (若有綁 Bot)Conversations 看得到 Ava 自動回話(Bot 行為有執行)。
    Success means all of the following hold:
    ① Contacts-27 shows the imported contacts (data made it into SW);
    ② Ava Conversations shows the thread + the first message delivered (the message reached Ava);
    ③ Ava Stats count > 0 (the Action was actually triggered and executed);
    ④ (if a Bot is attached) Conversations shows Ava auto-replying (Bot behavior executed).

🛠️

沒動?依這個順序排查:
1. Action 有沒有建、有沒有指派給 Segment——最常見原因(匯入了卻沒動多半是這)。
2. App Integration 的 Account ID 是否填對 Ava Account ID、Sandbox 是否有勾(stg 環境必勾)——填錯或沒勾 Sandbox,SW 查不到 Ava Campaign、Action 呼叫 Ava 也會失敗。
3. Asset 的 Campaign 下拉有沒有選到正確的 Ava Campaign。
4. Campaign Settings 的 P0 有沒有設——Bot 沒綁就沒有自動回話;Conversation Channel 不對訊息走錯路徑。
5. 門號有沒有綁、營業時段(Business Hours)/ TCPA / Holiday 是否 Follow——Follow 模式下遇到非營業時段會 Queued 到下次可用時段,看起來像「沒發」。
6. Segment Trigger 的 Enabled 有沒有開、Type/Schedule 設對沒。
7. 美加號碼:A2P(10DLC)有沒有 Approved——SW/Ava 兩端 log 都顯示「已送出」、Stats 計數也 > 0,但客戶就是收不到簡訊,十之八九是這個:電信商在看不見的那一層把訊息過濾掉了。