AWS 合作夥伴中心 API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 [AWS 合作夥伴中心 API 參考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用潛在客戶
## 什麼是潛在客戶？
在business-to-business(B2B) 銷售中，潛在客戶代表對公司的產品或服務表達興趣，但尚未完全符合銷售機會資格的潛在客戶。潛在客戶是銷售管道的初始階段，需要培養和資格，才能轉換為主動共同銷售的機會AWS。
AWS與合作夥伴共用的潛在客戶是以客戶參與訊號為基礎，例如網路研討會出席、行銷活動參與或合作夥伴解決方案查詢。這些潛在客戶包括寶貴的內容，例如客戶公司資訊、業務問題和參與詳細資訊，以協助合作夥伴排定優先順序並確定潛在機會的資格。
## 使用潛在客戶邀請
當潛在客戶對合作夥伴解決方案或服務表達興趣AWS時，合作夥伴會收到來自 的潛在客戶邀請。潛在客戶邀請程序可讓合作夥伴在承諾參與之前評估潛在客戶，確保有效率的資源分配和更高的轉換率。
### 接收潛在客戶邀請
AWS會建立潛在客戶邀請，並透過銷售 API 與合作夥伴共用。當有新的潛在客戶邀請可用時，AWS會將含潛在客戶內容的參與邀請傳送給符合資格的合作夥伴。
合作夥伴應使用 Amazon EventBridge 監控`Engagement Invitation Created`事件。此事件通知包含設為 `payloadType`的欄位`LeadInvitation`，可讓合作夥伴區分潛在客戶邀請與機會邀請。收到事件時，合作夥伴可以擷取邀請詳細資訊來評估潛在客戶。
### 列出潛在客戶邀請
合作夥伴可以使用 `ListEngagementInvitations` API 動作檢視其所有主要邀請。此動作會擷取呼叫委託人為寄件者或接收者的邀請。
若要特別針對潛在客戶邀請進行篩選，合作夥伴應使用值為 的`payloadType`篩選條件`LeadInvitation`。此篩選條件可確保只傳回潛在客戶邀請，從結果中排除機會邀請。
潛在客戶邀請可以處於下列狀態：
+ **待**定：等待合作夥伴接受或拒絕
+ **已接受**：合作夥伴已接受邀請並取得完整潛在客戶詳細資訊的存取權
+ **已拒絕**：合作夥伴已拒絕邀請
+ **已過期**：邀請已超過其過期日期，無需採取動作
## 評估潛在客戶邀請
接受潛在客戶邀請之前，合作夥伴應該使用 `GetEngagementInvitation` API 動作擷取詳細的邀請資訊。這為做出明智的接受或拒絕決策提供了基本內容。
領導邀請承載包括：
**客戶資訊 （可用的預先接受）：**
+ 公司名稱、產業和國家/地區
+ 網站 URL
+ 市場客群 （企業、大型、中型、小型、微型）
+ AWS成熟度層級 （評估、單一帳戶、多帳戶）
**客戶互動：**
+ 來源類型和行銷活動資訊
+ 客戶採取的動作 （表單完成、參加網路研討會等）
+ 客戶提供的業務問題描述
+ 使用案例類別
+ 聯絡人標題 （提供 BANT 資格的授權內容）
**重要**
邀請階段看不到客戶聯絡資訊 （名稱、電子郵件、電話號碼）。只有在接受邀請、確保客戶隱私權並防止潛在客戶耕作行為之後，聯絡人詳細資訊才會變成可用。
## 接受潛在客戶邀請
當合作夥伴決定尋求潛在客戶時，他們必須使用 `AcceptEngagementInvitation` API 動作接受邀請。此動作會將合作夥伴新增至業務開發，並授予完整潛在客戶詳細資訊的存取權，包括客戶聯絡資訊。
接受後：
+ 合作夥伴會新增為參與的成員
+ 客戶聯絡資訊會透過業務開發主管內容顯示
+ 潛在客戶在AWS系統中被歸類為合作夥伴合格潛在客戶 (PQL)
+ 潛在客戶會出現在合作夥伴的作用中潛在客戶清單中
+ 合作夥伴可以開始培養潛在客戶並建立客戶聯絡
合作夥伴可以透過`AcceptEngagementInvitation`為每個邀請呼叫 ，以程式設計方式接受多個潛在客戶邀請，從而有效地大量處理高品質潛在客戶。
## 拒絕潛在客戶邀請
如果潛在客戶不符合合作夥伴的功能、容量或業務重點，合作夥伴可以使用 `RejectEngagementInvitation` API 動作拒絕邀請。拒絕潛在客戶邀請時，合作夥伴應提供拒絕原因，以協助AWS改善潛在客戶路由和比對。常見的拒絕原因包括：
+ 缺乏地理覆蓋範圍
+ 使用案例的技術專業知識不足
+ 目前的容量限制條件
+ 客戶產業不相符
+ 預算不一致
拒絕之後：
+ 潛在客戶已從合作夥伴的待定邀請佇列中移除
+ 絕不會與合作夥伴共用客戶聯絡資訊
+ 潛在客戶在AWS系統中被歸類為合作夥伴拒絕潛在客戶 (PRL)
+ 邀請仍會顯示在合作夥伴拒絕的邀請清單中以供參考
如果符合客戶同意要求，拒絕的潛在客戶可能有資格重新指派給其他合作夥伴。
## 管理已接受的潛在客戶
接受潛在客戶邀請後，合作夥伴可以存取完整的潛在客戶資訊、培養客戶關係，以及追蹤潛在客戶的資格階段。
### 檢視潛在客戶詳細資訊
合作夥伴會使用 `GetEngagement` API 動作存取完整的潛在客戶詳細資訊。業務開發包含潛在客戶內容，其中包含有關客戶及其互動的完整資訊AWS。
潛在客戶內容包括：
**完成客戶設定檔：**
+ 來自原始邀請的所有公司資訊
+ 所有客戶互動的完整聯絡詳細資訊 （姓名、電子郵件、電話、公司職稱）
+ AWS成熟度層級和市場客群
**互動歷史記錄：**
+ 將多個客戶接觸點合併為單一互動
+ 每個互動都包含來源資訊、客戶動作、業務問題和聯絡詳細資訊
+ 互動會依時間順序列出，以提供完整的客戶旅程檢視
**資格狀態：**
+ 潛在客戶資格的目前狀態 （不合格、合格、取消資格或自訂狀態）
+ 合作夥伴可以在資格程序進行時更新此狀態
此全方位檢視可讓合作夥伴了解客戶跨多個AWS行銷活動和接觸點的完整互動歷程記錄，而不是將每次互動視為單獨的潛在客戶。
### 列出作用中潛在客戶
合作夥伴可以使用 `ListEngagements` API 動作將`contextType`篩選條件設定為 來擷取其所有作用中的潛在客戶`Lead`。這會傳回合作夥伴是成員且參與包含潛在客戶內容的參與。
清單回應包含重要資訊，例如：
+ 業務開發 ID 和標題
+ 客戶公司名稱
+ 目前的參與度分數
+ 資格狀態
+ 互動次數
+ 建立和修改時間戳記
合作夥伴可以使用此清單來建置儀表板、追蹤潛在客戶管道運作狀態，以及識別需要注意的潛在客戶。
### 使用 Prospecting Insights 豐富潛在客戶
合作夥伴可以利用AWS洞察來豐富接受的潛在客戶，在投資推廣之前更好地排定優先順序並讓他們符合資格。透過探勘任務以非同步方式執行富集，該任務可增強與AWS衍生訊號的領導參與，以支援資格決策。
**啟動探勘任務**
合作夥伴使用 `StartProspectingFromEngagementTask` API 動作啟動擴充。此動作在單一請求中接受最多 100 個參與識別符，允許合作夥伴批次富集潛在客戶。任務會以非同步方式執行，並立即傳回 `TaskId`和 合作夥伴用來追蹤進度`TaskArn`的 。初始`TaskStatus`是 `PENDING`、`IN_PROGRESS`、 `COMPLETED`或 之一`FAILED`。
合作夥伴可以選擇性地提供 `TaskName`來標記任務，也可以提供 `ClientToken`來確保重試之間的冪等性。
**輪詢結果**
由於探勘是非同步的，合作夥伴會使用 `GetProspectingFromEngagementTask` API 動作與開始時`TaskId`傳回的 輪詢完成。回應會針對每個提交的識別符，報告整體任務狀態和每個參與結果。
每個業務開發都是獨立處理的，因此個別業務開發可以成功或失敗，而不會影響相同任務中的其他業務開發。對於每個互動，結果包括：
+ **業務開發識別符**：已處理的業務開發。
+ **狀態**：`PENDING`、`COMPLETED`、 `IN_PROGRESS`或 `FAILED`。
+ **勘探內容識別符**：成功處理參與時填入。此識別符會參考新增至參與的豐富探勘內容，並可用於後續操作。
+ **原因代碼和訊息**：僅在參與失敗時填入，提供列舉的失敗代碼和具有建議復原步驟的人類可讀取描述。
**監控多個任務**
為了追蹤許多潛在客戶的擴充，合作夥伴會使用 `ListProspectingFromEngagementTasks` API 動作。此動作會列出發起人帳戶啟動的所有探勘任務，並支援依任務識別符、任務名稱或啟動時間範圍的選用篩選條件，以及可設定的排序。回應會分頁；使用每個回應中的 `NextToken` 值來擷取後續頁面。
當擴充成功完成時，AWS洞見會新增至業務開發中，做為潛在客戶開發內容。合作夥伴可以使用 擷取富集的詳細資訊`GetEngagement`，並使用它們來設定潛在客戶的資格狀態，並決定哪些會導致轉換進展。
### 更新潛在客戶資訊
當合作夥伴培養潛在客戶並收集其他資訊時，他們可以使用 `UpdateEngagementContext` API 動作更新潛在客戶詳細資訊。此動作可讓合作夥伴修改業務開發中的潛在客戶內容。
合作夥伴可以更新：
**資格狀態：**合作夥伴應在進行內部資格程序時更新資格狀態：
+ **不合格**：接受潛在客戶後的預設狀態；表示潛在客戶需要評估
+ **合格**：潛在客戶符合資格條件，並顯示轉換為機會的高潛力
+ **不符合資格**：潛在客戶不符合條件或不適合合作夥伴的解決方案
+ **自訂狀態**：合作夥伴可以定義自己的資格狀態，以符合其內部程序
**潛在客戶中繼資料：**合作夥伴可以新增或更新與其資格和培養程序相關的其他資訊。
更新資格狀態有助於合作夥伴追蹤潛在客戶進度、產生準確的管道報告，並識別準備好轉換為機會的潛在客戶。
### 監控AWS更新
AWS可能會根據新的客戶互動訊號或精簡互動評分來更新潛在客戶資訊。AWS更新互動時，合作夥伴會透過 Amazon EventBridge 接收`Engagement Updated`事件。
這些更新可能包括：
+ 根據新客戶活動來精簡參與度分數
+ 來自新行銷活動或接觸點的其他客戶互動
+ 更新客戶資訊
合作夥伴應監控這些事件並呼叫 `GetEngagement`以擷取最新的潛在客戶詳細資訊。這可確保合作夥伴擁有排定優先順序和培養潛在客戶的最新資訊。
`Engagement Updated` 事件包含 `contextTypes` 欄位，允許合作夥伴專門針對潛在客戶進行篩選 （使用潛在客戶內容進行互動）。
## 將潛在客戶轉換為機會
當潛在客戶符合資格並展現嚴重的購買意圖時，合作夥伴可以將其轉換為正式與 共同銷售合作的機會AWS。此轉換會標記從領導培養 （主要由合作夥伴驅動） 到機會管理 （與 合作） 的轉換AWS。
### 建議方法：便利 API
合作夥伴可以使用`StartOpportunityFromEngagementTask`方便的 API 動作，簡化機會建立和連結程序。此任務 API 會自動協調多個動作：
1. 使用潛在客戶內容的初步資訊建立草案機會
1. 透過資源快照將機會連結至來源參與
1. 將 CustomerProject 內容新增至業務開發
此便利方法可減少所需的 API 呼叫數量，並確保適當的歸因追蹤。使用此方法的合作夥伴仍需要：
+ 使用 完成機會詳細資訊 `UpdateOpportunity`
+ 使用 關聯合作夥伴解決方案 `AssociateOpportunity`
+ 準備就緒`StartEngagementFromOpportunityTask`時使用 提交機會
對於希望將整合複雜性降至最低lead-to-opportunity工作流程合作夥伴來說，便利 API 特別有用。
### 替代方法：Step-by-step API
**建立草稿機會**
轉換潛在客戶的第一步是使用 `CreateOpportunity` API 動作建立草案機會。這會建立將 `Lifecycle.ReviewStatus`設為 的機會`Pending Submission`。在此階段，機會尚未提交至AWS進行驗證。
合作夥伴應將潛在客戶培養期間收集的資訊填入機會，包括：
+ 客戶帳戶詳細資訊
+ 專案資訊和業務問題
+ 預期的客戶支出
+ 目標結束日期
+ 資格期間收集的任何其他相關詳細資訊
草案機會可讓合作夥伴在提交 之前準備完整的資訊AWS，確保更高的核准率和更快的驗證。
**將機會連結至領導參與**
建立草案機會後，合作夥伴必須使用 `CreateResourceSnapshot` API 動作將其連結至來源潛在客戶參與。此步驟對於下列項目至關重要：
+ **屬性追蹤**：從潛在客戶邀請到機會關閉建立來源鏈，為行銷活動和潛在客戶來源提供準確的投資報酬率計算。
+ **轉換指標**：允許AWS和 合作夥伴測量lead-to-opportunity轉換率，並識別成功的潛在客戶來源。
+ **內容保留**：維護完整的客戶旅程歷史記錄，包括所有原始互動和互動訊號。
建立資源快照時，合作夥伴會指定：
+ 業務開發 ID （來源領導業務開發）
+ 機會識別符
+ 資源類型 （機會）
此動作會自動將 CustomerProject 內容新增至參與，表示潛在客戶已轉換為作用中的機會。參與現在同時包含原始潛在客戶內容 （保留歷史記錄） 和新的 CustomerProject 內容 （指出作用中的機會）。
**完成機會詳細資訊**
建立並連結機會後，合作夥伴必須先完成其他機會要求，才能提交。如需詳細資訊，請參閱 `AssociateOpportunity` API 動作。
更新專案詳細資訊：合作夥伴可以使用 `UpdateOpportunity` API 動作來精簡專案資訊、客戶業務問題、預期支出，以及在潛在客戶資格期間收集的其他相關詳細資訊。
**提交機會**
所有必要資訊完成後，合作夥伴會使用`StartEngagementFromOpportunityTask`方便的 API 提交AWS驗證機會。這會將機會從草稿狀態轉換為AWS檢閱程序。
驗證要求：參與在提交之前必須具有 CustomerProject 內容。使用 `CreateResourceSnapshot`將機會連結至參與時，會自動建立此內容。如果缺少此內容，提交將會失敗。
提交後：
+ 機會`Lifecycle.ReviewStatus`的變更 `Submitted`
+ 潛在客戶在AWS系統中被歸類為合作夥伴銷售合格潛在客戶 (PSQL)
+ AWS開始驗證，以確保機會詳細資訊準確且完整
+ 在檢閱程序完成之前，無法對機會進行任何變更
機會接著會遵循「使用機會」文件中描述的標準驗證工作流程，逐步完成審核中、必要動作、已核准或取消資格等狀態。