AWS Partner Central API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 AWS Partner Central API 參考。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用潛在客戶

什麼是潛在客戶？

在business-to-business(B2B) 銷售中，潛在客戶代表對公司的產品或服務表達興趣，但尚未完全符合銷售機會資格的潛在客戶。潛在客戶是銷售管道的初始階段，需要培養和資格，才能轉換為主動共同銷售的機會AWS。

AWS與合作夥伴共用的潛在客戶是以客戶參與訊號為基礎，例如網路研討會出席、行銷活動參與或合作夥伴解決方案查詢。這些潛在客戶包括寶貴的內容，例如客戶公司資訊、業務問題和參與詳細資訊，以協助合作夥伴排定優先順序並確定潛在機會的資格。

使用潛在客戶邀請

當潛在客戶對合作夥伴解決方案或服務表達興趣AWS時，合作夥伴會收到來自 的潛在客戶邀請。潛在客戶邀請程序可讓合作夥伴在承諾參與之前評估潛在客戶，確保有效率的資源分配和更高的轉換率。

接收潛在客戶邀請

AWS會建立潛在客戶邀請，並透過銷售 API 與合作夥伴共用。當有新的潛在客戶邀請可用時，AWS會將含潛在客戶內容的參與邀請傳送給符合資格的合作夥伴。

合作夥伴應使用 Amazon EventBridge 監控Engagement Invitation Created事件。此事件通知包含設為 payloadType的欄位LeadInvitation，可讓合作夥伴區分潛在客戶邀請與機會邀請。收到事件時，合作夥伴可以擷取邀請詳細資訊來評估潛在客戶。

列出潛在客戶邀請

合作夥伴可以使用 ListEngagementInvitations API 動作檢視其所有主要邀請。此動作會擷取呼叫委託人為寄件者或接收者的邀請。

若要特別針對潛在客戶邀請進行篩選，合作夥伴應使用值為 的payloadType篩選條件LeadInvitation。此篩選條件可確保只傳回潛在客戶邀請，從結果中排除機會邀請。

潛在客戶邀請可以處於下列狀態：

評估潛在客戶邀請

接受潛在客戶邀請之前，合作夥伴應該使用 GetEngagementInvitation API 動作擷取詳細的邀請資訊。這為做出明智的接受或拒絕決策提供了基本內容。

領導邀請承載包括：

客戶資訊 （可用的預先接受）：

客戶互動：

接受潛在客戶邀請

當合作夥伴決定尋求潛在客戶時，他們必須使用 AcceptEngagementInvitation API 動作接受邀請。此動作會將合作夥伴新增至業務開發，並授予完整潛在客戶詳細資訊的存取權，包括客戶聯絡資訊。

接受後：

合作夥伴可以透過AcceptEngagementInvitation為每個邀請呼叫 ，以程式設計方式接受多個潛在客戶邀請，從而有效地大量處理高品質潛在客戶。

拒絕潛在客戶邀請

如果潛在客戶不符合合作夥伴的功能、容量或業務重點，合作夥伴可以使用 RejectEngagementInvitation API 動作拒絕邀請。拒絕潛在客戶邀請時，合作夥伴應提供拒絕原因，以協助AWS改善潛在客戶路由和比對。常見的拒絕原因包括：

拒絕之後：

如果符合客戶同意要求，拒絕的潛在客戶可能有資格重新指派給其他合作夥伴。

管理已接受的潛在客戶

接受潛在客戶邀請後，合作夥伴可以存取完整的潛在客戶資訊、培養客戶關係，以及追蹤潛在客戶的資格階段。

檢視潛在客戶詳細資訊

合作夥伴會使用 GetEngagement API 動作存取完整的潛在客戶詳細資訊。業務開發包含潛在客戶內容，其中包含有關客戶及其互動的完整資訊AWS。

潛在客戶內容包括：

完成客戶設定檔：

互動歷史記錄：

資格狀態：

此全方位檢視可讓合作夥伴了解客戶跨多個AWS行銷活動和接觸點的完整互動歷程記錄，而不是將每次互動視為單獨的潛在客戶。

列出作用中潛在客戶

合作夥伴可以使用 ListEngagements API 動作將contextType篩選條件設定為 來擷取其所有作用中的潛在客戶Lead。這會傳回合作夥伴是成員且參與包含潛在客戶內容的參與。

清單回應包含重要資訊，例如：

合作夥伴可以使用此清單來建置儀表板、追蹤潛在客戶管道運作狀態，以及識別需要注意的潛在客戶。

使用 Prospecting Insights 豐富潛在客戶

合作夥伴可以利用AWS洞察來豐富接受的潛在客戶，在投資推廣之前更好地排定優先順序並讓他們符合資格。透過探勘任務以非同步方式執行富集，該任務可增強與AWS衍生訊號的領導參與，以支援資格決策。

啟動探勘任務

合作夥伴使用 StartProspectingFromEngagementTask API 動作啟動擴充。此動作在單一請求中接受最多 100 個參與識別符，允許合作夥伴批次富集潛在客戶。任務會以非同步方式執行，並立即傳回 TaskId和 合作夥伴用來追蹤進度TaskArn的 。初始TaskStatus是 PENDING、IN_PROGRESS、 COMPLETED或 之一FAILED。

合作夥伴可以選擇性地提供 TaskName來標記任務，也可以提供 ClientToken來確保重試之間的冪等性。

輪詢結果

由於探勘是非同步的，合作夥伴會使用 GetProspectingFromEngagementTask API 動作與開始時TaskId傳回的 輪詢完成。回應會針對每個提交的識別符，報告整體任務狀態和每個參與結果。

每個業務開發都是獨立處理的，因此個別業務開發可以成功或失敗，而不會影響相同任務中的其他業務開發。對於每個互動，結果包括：

監控多個任務

為了追蹤許多潛在客戶的擴充，合作夥伴會使用 ListProspectingFromEngagementTasks API 動作。此動作會列出發起人帳戶啟動的所有探勘任務，並支援依任務識別符、任務名稱或啟動時間範圍的選用篩選條件，以及可設定的排序。回應會分頁；使用每個回應中的 NextToken 值來擷取後續頁面。

當擴充成功完成時，AWS洞見會新增至業務開發中，做為潛在客戶開發內容。合作夥伴可以使用 擷取富集的詳細資訊GetEngagement，並使用它們來設定潛在客戶的資格狀態，並決定哪些會導致轉換進展。

更新潛在客戶資訊

當合作夥伴培養潛在客戶並收集其他資訊時，他們可以使用 UpdateEngagementContext API 動作更新潛在客戶詳細資訊。此動作可讓合作夥伴修改業務開發中的潛在客戶內容。

合作夥伴可以更新：

資格狀態：合作夥伴應在進行內部資格程序時更新資格狀態：

潛在客戶中繼資料：合作夥伴可以新增或更新與其資格和培養程序相關的其他資訊。

更新資格狀態有助於合作夥伴追蹤潛在客戶進度、產生準確的管道報告，並識別準備好轉換為機會的潛在客戶。

監控AWS更新

AWS可能會根據新的客戶互動訊號或精簡互動評分來更新潛在客戶資訊。AWS更新互動時，合作夥伴會透過 Amazon EventBridge 接收Engagement Updated事件。

這些更新可能包括：

合作夥伴應監控這些事件並呼叫 GetEngagement以擷取最新的潛在客戶詳細資訊。這可確保合作夥伴擁有排定優先順序和培養潛在客戶的最新資訊。

Engagement Updated 事件包含 contextTypes 欄位，允許合作夥伴專門針對潛在客戶進行篩選 （使用潛在客戶內容進行互動）。

將潛在客戶轉換為機會

當潛在客戶符合資格並展現嚴重的購買意圖時，合作夥伴可以將其轉換為正式與 共同銷售合作的機會AWS。此轉換會標記從領導培養 （主要由合作夥伴驅動） 到機會管理 （與 合作） 的轉換AWS。

建議方法：便利 API

合作夥伴可以使用StartOpportunityFromEngagementTask方便的 API 動作，簡化機會建立和連結程序。此任務 API 會自動協調多個動作：

此便利方法可減少所需的 API 呼叫數量，並確保適當的歸因追蹤。使用此方法的合作夥伴仍需要：

對於希望將整合複雜性降至最低lead-to-opportunity工作流程合作夥伴來說，便利 API 特別有用。

替代方法：Step-by-step API

建立草稿機會

轉換潛在客戶的第一步是使用 CreateOpportunity API 動作建立草案機會。這會建立將 Lifecycle.ReviewStatus設為 的機會Pending Submission。在此階段，機會尚未提交至AWS進行驗證。

合作夥伴應將潛在客戶培養期間收集的資訊填入機會，包括：

草案機會可讓合作夥伴在提交 之前準備完整的資訊AWS，確保更高的核准率和更快的驗證。

將機會連結至領導參與

建立草案機會後，合作夥伴必須使用 CreateResourceSnapshot API 動作將其連結至來源潛在客戶參與。此步驟對於下列項目至關重要：

建立資源快照時，合作夥伴會指定：

此動作會自動將 CustomerProject 內容新增至參與，表示潛在客戶已轉換為作用中的機會。參與現在同時包含原始潛在客戶內容 （保留歷史記錄） 和新的 CustomerProject 內容 （指出作用中的機會）。

完成機會詳細資訊

建立並連結機會後，合作夥伴必須先完成其他機會要求，才能提交。如需詳細資訊，請參閱 AssociateOpportunity API 動作。

更新專案詳細資訊：合作夥伴可以使用 UpdateOpportunity API 動作來精簡專案資訊、客戶業務問題、預期支出，以及在潛在客戶資格期間收集的其他相關詳細資訊。

提交機會

所有必要資訊完成後，合作夥伴會使用StartEngagementFromOpportunityTask方便的 API 提交AWS驗證機會。這會將機會從草稿狀態轉換為AWS檢閱程序。

驗證要求：參與在提交之前必須具有 CustomerProject 內容。使用 CreateResourceSnapshot將機會連結至參與時，會自動建立此內容。如果缺少此內容，提交將會失敗。

提交後：

機會接著會遵循「使用機會」文件中描述的標準驗證工作流程，逐步完成審核中、必要動作、已核准或取消資格等狀態。