Ava 功能說明Ava features
A2P(10DLC 簡訊合規)A2P (10DLC SMS compliance)
設定位置:帳號 Settings → A2P 頁籤(見 介面導覽)。Where: account Settings → A2P tab (see the interface tour).
📵A2P(10DLC 簡訊合規)詳解 Account Settings → A2P P0
A2P(Application-to-Person)是美加電信商要求的簡訊發送方登記制度(業界稱 10DLC)。沒登記或登記未通過,長碼號碼發簡訊會被電信商標記為垃圾/詐騙並過濾,收件人根本收不到——即使 SW 的 Action 確實觸發、Ava 也確實呼叫了 Twilio 送出。這是「訊息明明有發、對方卻收不到」最常見卻最容易被忽略的原因,因為 SW/Ava 兩端的 log 和 Stats 都會顯示「已送出」,問題出在電信商那一層看不到。A2P (Application-to-Person) is a carrier-mandated sender registration scheme for US/Canada SMS (industry name: 10DLC). Without an approved registration, long-code SMS gets flagged as spam/fraud and filtered by carriers before it reaches the recipient — even though SW's Action fired and Ava did call Twilio to send. This is the most common yet most overlooked cause of "it sent but they never got it," because both SW and Ava logs/Stats will show "sent" — the block happens at the carrier layer, invisible to either system.
Draft → Pending → In Progress → Approved(或 Rejected);只有 Draft/Rejected 狀態能編輯重送。A2P Settings → Business Profile section → "Create Business Profile". An account can only have one Business Profile (the create button disables once one exists). Status flows Draft → Pending → In Progress → Approved (or Rejected); only Draft/Rejected can be edited and resubmitted.Friendly Name;Campaign Usage(用途分類,如 2FA、Marketing、Customer Care、Account Notification 等,每個附說明 tooltip);Description(40–4096 字,說明誰發、發給誰、為何發);Message Flow(40–2048 字,說明收件人如何 opt-in 同意收訊息);Has Embedded Links / Has Embedded Phone(訊息是否含連結/電話);Message Sample ×2~5(20–1024 字,樣本訊息須與上面的 Description/Usage 一致)。⚠️ 刪除這個 Campaign 會連動刪除電信商那邊真正的 10DLC 申請,官方建議只在申請被拒或卡住時才刪。A2P Settings → A2P Campaigns section → "Create A2P Campaign", enabled only once the Brand is Approved (a tooltip explains this on the disabled button). Fields: Friendly Name; Campaign Usage (e.g. 2FA, Marketing, Customer Care, Account Notification — each with an explanatory tooltip); Description (40–4096 chars: who's sending, to whom, and why); Message Flow (40–2048 chars: how the recipient opted in); Has Embedded Links / Has Embedded Phone; 2–5 Message Samples (20–1024 chars, must align with the Description/Usage above). ⚠️ Deleting this Campaign also deletes the real 10DLC application at the carrier — only recommended when the application is rejected or stuck.四層依序卡關:Business Profile → Trust Bundle → Brand → A2P Campaign,每一層都要前一層通過(非 Draft)才能開始下一層,任何一層卡在 Pending/In Progress 都會讓後面全部卡住。狀態不是即時的,審核由電信商端進行,可能要數天。練習用 stg 帳號通常不需要真的走完 A2P(測試門號、低流量),但要對客戶或 prod 帳號送真實簡訊,務必提前確認 A2P 全部 Approved,不要等到「訊息送不出去」才回頭查。
另外要留意 Inherit Existed Twilio Account:若這個 Ava Account 是沿用別的帳號的 Twilio(從 0 開始 Phase 1「建立新的 Ava Account」步驟提過的選項),A2P 頁面上方會顯示「Inherit Twilio Account」,代表 A2P 資格跟著被沿用的帳號走,不用也不能在這個帳號重新申請。同樣地,Phone Numbers 底下的 Area Code Coverage、Number Health Stats 也要切到被沿用的那個帳號才看得到資料(見 Ava 介面導覽)。Four sequential gates: Business Profile → Trust Bundle → Brand → A2P Campaign — each requires the previous one Approved (past Draft) before it can start, and any layer stuck at Pending/In Progress blocks everything after it. Status isn't instant; carriers review it and it can take days. A stg practice account usually doesn't need to fully complete A2P (test numbers, low volume), but before sending real SMS to customers or on a prod account, confirm A2P is fully Approved ahead of time — don't wait until messages stop arriving to check.
Also watch for Inherit Existed Twilio Account: if this Ava Account reuses another account's Twilio (the option mentioned in Track A's Phase 1 "Create a new Ava Account" step), the A2P page shows "Inherit Twilio Account" at the top — meaning A2P eligibility follows the inherited account and can't (and needn't) be re-applied for on this one. Likewise, Area Code Coverage and Number Health Stats under Phone Numbers only show data on the inherited account (see the Ava tour).
各環境新建 Account 時,A2P 要 Inherit 哪個帳號Which account to inherit A2P from, per environment
練習或新建 Account 時,不要自己重新跑一遍 A2P 申請——直接在 Create New Account 的 Inherit Existed Twilio Account 選下面對應環境的既有帳號,沿用它已經 Approved 的 A2P 資格。When creating a new Account for practice or real use, don't re-run the A2P application yourself — in Create New Account, set Inherit Existed Twilio Account to the existing account below for that environment, reusing its already-Approved A2P eligibility.
| 環境Env | 要 Inherit 的帳號Account to inherit |
|---|---|
| stg | AfforHousing - test (ID: 1) |
| prod | y_Back Up Bots - Jimmy Test (ID: 75) |
| cl1 | x_Jimmy Test (ID: 155) |