이벤트를 모니터링하기 위한 사전 조건 완료 이벤트를 모니터링하도록 Amazon EventBridge 구성 API 이벤트 판매에 대해 자세히 알아보기

AWS Partner Central Selling API에 대한 알림

판매 API 이벤트는 상태 변경 또는 기회 세부 정보에 대한 실시간 알림을 제공합니다. 이러한 이벤트는 시스템을AWS Partner Central과 동기화하고 적시에 응답 및 업데이트를 보장하는 데 도움이 됩니다.

주제

이벤트를 모니터링하기 위한 사전 조건 완료
이벤트를 모니터링하도록 Amazon EventBridge 구성
API 이벤트 판매에 대해 자세히 알아보기

이벤트를 모니터링하기 위한 사전 조건 완료

사용자는 Partner Central 판매 API에서 게시한 이벤트에 액세스하고 관리하려면 적절한 IAM 권한이 필요합니다. EventBridge에 사용할 수 있는 작업, 리소스 및 조건 키에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의 Amazon EventBridge에서 IAM 정책 조건 사용을 참조하세요. EventBridge 조건 키 중 하나는 특정 이벤트 유형에 대한 권한 범위를 지정하는 데 사용할 수 events:detail-type있는 입니다.

다음 예제 정책은 제안된 이벤트에 대한 권한을 사용자 지정하고 범위를 지정하는 방법을 보여줍니다. AllowPutRuleForPartnercentralSellingEvents 문은 규칙 생성을 허용하지만 aws.partnercentral-selling 소스의 이벤트에 대해서만 가능합니다.

이벤트를 모니터링하도록 Amazon EventBridge 구성

API 이벤트 판매를 모니터링하려면 캡처하려는 이벤트와 일치하는 EventBridge 규칙을 생성합니다.AWS Management Console또는AWS SDKs를 사용하여 규칙을 생성하고 관리할 수 있습니다. 다음 섹션에서는 두 방법을 모두 사용하여 규칙을 생성하는 방법을 설명합니다. 사용하는 방법에 관계없이 미국 동부(버지니아 북부) us-east-1 리전에서 규칙을 생성해야 합니다.

AWS Management Console설정

를 사용하여 EventBridge 규칙을 설정하려면 Amazon EventBridge 사용 설명서의 Amazon EventBridge에서 이벤트에 반응하는 규칙 생성의 단계를AWS Management Console따릅니다. EventBridge 규칙을 생성할 때 이벤트 버스를 기본값으로 설정하고 미국 동부(버지니아 북부) us-east-1 리전에서 규칙을 생성해야 합니다.

다음은 이벤트 규칙의 예입니다.


{
    "source": ["aws.partnercentral-selling"],
    "detail": {
        "catalog": ["AWS"]
    }
}

AWS SDK 설정

AWS SDKs를 사용하여 EventBridge 규칙을 프로그래밍 방식으로 생성하고 관리할 수 있습니다. 자세한 내용은 Amazon EventBridge API 참조의 PutRule을 참조하세요.

다음 예제에서는AWS SDK for Python(Boto3)을 사용합니다.


import boto3

client = boto3.client('events', region_name='us-east-1')

response = client.put_rule(
    Name='MyOpportunityCreatedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-selling"], 
        "detail-type": ["Opportunity Created"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

API 이벤트 판매에 대해 자세히 알아보기

다음 섹션에서는 판매 API 이벤트 유형, 이를 트리거하는 시나리오 및 이벤트 예제를 설명합니다.

이벤트 유형

다음은 이벤트 유형과 트리거입니다.

기회 생성됨: 새 기회가 생성될 때 트리거됩니다.
기회 업데이트됨: 기회(기회 또는 해당AWS기회 요약)가 업데이트될 때 트리거됩니다.
참여 초대 생성됨:AWS추천 초대가 생성될 때 트리거됩니다.
참여 초대 수락: 파트너가AWS참여 초대를 수락하여 기회에 대해와 협력하는 데 관심이 있음을 확인하면 트리거AWS됩니다.
참여 초대 거부됨: 파트너가AWS참여 초대를 거부할 때 트리거됩니다.
참여 초대 만료됨: 파트너가 EngagementInvitation를 거부할 때이 이벤트가 트리거됩니다. 발신 및 수신 파트너에게 초대가 만료되었음을 알립니다.
참여 구성원 추가됨:이 이벤트는 초대를 수락한 후 새 구성원이 참여에 참여할 때 트리거됩니다. 이 정책은 참여의 모든 현재 구성원에게 참여에 추가되는 새 구성원에 대해 알립니다.
참여 리소스 스냅샷 생성됨:이 이벤트는 참여와 연결된 리소스(예: 기회)의 스냅샷의 새 개정이 생성될 때 트리거됩니다. 연결된 리소스 스냅샷의 변경 사항에 대해 참여의 모든 현재 구성원에게 알립니다.
참여 생성됨: 새 참여 생성 시 트리거됩니다.
참여 업데이트됨: 참여 업데이트 시 트리거됩니다.

이벤트 시나리오

다음 표에서는 다양한 시나리오에서 이벤트가 작동하는 방식을 설명합니다. 이러한 시나리오에서는 다음과 같은 가정이 이루어집니다.

AWS는 이러한 시나리오의 파트너이기도 합니다.
ResourceSnapshotJob 파트너가를 올바르게 구성했습니다.
기회에 대해 업데이트된 필드는 리소스 스냅샷에 대한 기회 템플릿에도 있습니다.

파트너로서 사용자의 작업	수신된 이벤트	참가자 유형
기회를 생성합니다.	기회 생성됨
`StartEngagementFromOpportunityTask`를 사용하여 기회를 제출합니다.	기회 업데이트됨, 참여 생성됨, 참여 리소스 스냅샷 생성됨, 참여 구성원 추가됨, 참여 초대 생성됨
AWS가 제출된 기회를 승인합니다.	참여 초대 수락됨, 참여 구성원 추가됨, 기회 업데이트됨, 참여 리소스 스냅샷 생성됨
AWS는 제출된 기회를 거부합니다.	참여 초대 거부됨, 기회 업데이트됨, 참여 리소스 스냅샷 생성됨
AWS Marketplace제안을 기회와 연결	기회 업데이트됨
솔루션을 기회와 연결	기회 업데이트됨, 참여 리소스 스냅샷 생성됨
기회를 업데이트합니다.	기회 업데이트됨, 참여 리소스 스냅샷 생성됨(`ResourceSnapshotJob`이 설정되어 있고 필드 업데이트가 템플릿에 있는 경우 선택 사항)
AWS가 기회를 업데이트합니다.	기회 업데이트됨, 참여 리소스 스냅샷 생성됨
다른 파트너를 참여에 초대합니다.	참여 초대 생성됨	발신자
파트너가 참여 초대를 수락함	참여 초대 수락, 참여 구성원 추가	발신자
파트너가 참여 초대를 거부함	참여 초대 거부됨	발신자
파트너가 15일 동안 참여 초대를 처리하지 않습니다.	참여 초대 만료됨	발신자
다른 파트너로부터 참여 초대를 받습니다.	참여 초대 생성됨	수신기
를 통해 다른 파트너의 참여 초대를 수락합니다. `StartEngagementByAcceptingInvitationTask`	참여 초대 수락됨, 참여 구성원 추가됨, 기회 생성됨, 기회 업데이트됨, 참여 리소스 스냅샷 생성됨	수신기
다른 파트너의 참여 초대를 거부하는 경우	참여 초대 거부됨	수신기
15일 동안 다른 파트너의 참여 초대에 대해 조치를 취하지 않습니다.	참여 초대 만료됨	수신기
참여를 생성합니다.	참여 생성됨	발신자
참여를 업데이트합니다.	참여 업데이트됨	발신자, 수신자

이벤트 예제

다음 섹션에서는 이전 섹션의 앞부분에 나열된 이벤트의 예를 제공합니다.

기회 생성됨

파트너는이 이벤트를 사용하여 다음을 수행합니다.

사용자에게 새 기회가 생성되었음을 알립니다.
CRM 시스템 업데이트 또는 영업 팀에 새로운 기회 생성 알림과 같은 자동화된 워크플로를 트리거합니다.

다음 예제에서는 일반적인 기회 생성 이벤트를 보여줍니다.


{
    "version": "1",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "source": "aws.partnercentral-selling",
    "detail-type": "Opportunity Created",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "account": "123456789012",
    "detail": {
        "schemaVersion": "<version number>",
        "catalog": "<Sandbox | AWS>",
        "opportunity": {
            "identifier": "String"
        }
    }
}

기회 업데이트됨

파트너는이 이벤트를 사용하여 다음을 수행합니다.

기존 기회가 업데이트되었음을 사용자에게 알립니다.
CRM 시스템 업데이트 또는 영업 팀에 알리는 등의 자동화된 워크플로를 트리거합니다.

다음 예제에서는 일반적인 기회 업데이트 이벤트를 보여줍니다.


{
    "version": "1",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "source": "aws.partnercentral-selling",
    "detail-type": "Opportunity Updated",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "account": "123456789012",
    "detail": {
        "schemaVersion": "<version number>",
        "catalog": "<Sandbox | AWS>",
        "opportunity": {
             "identifier": "String"
        }
    }
}

참여 초대 생성됨

파트너는이 이벤트를 사용하여 다음을 수행합니다.

사용자에게 수신한 새 EngagementInvitation에 대해 알립니다.
자동 워크플로를 트리거하여 CRM 시스템 업데이트 또는 영업 팀에 알리는 등 초대를 수락하거나 거부합니다.

다음 예제에서는 일반적인 참여 초대 생성 이벤트를 보여줍니다.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Created",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-15T12:34:56Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"
    ],
    "detail": {
      "catalog": "AWS",
      "engagementInvitation": {
        "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
        "id": "engi-v7p8z56whnauo",
        "engagementId": "eng-12345678901234",      
        "senderAccountId": "string",
        "receiverAccountId": "string",      
        "senderCompanyName": "string",
        "expirationDate": "string",
        "participantType": "Enum", //Sender/Receiver
		"payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation
      }
    }
}

참여 초대 수락됨

파트너는이 이벤트를 사용하여 다음을 수행합니다.

사용자에게 EngagementInvitation이 수락되었음을 알립니다.
참여의 새 파트너를 반영하도록 내부 레코드를 업데이트합니다.
자동화된 워크플로를 트리거하여 데이터를 동기화하거나 다른 팀원에게 새 참여 구성원에 대해 알립니다.

다음 예제에서는 일반적인 참여 초대 수락 이벤트를 보여줍니다.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Accepted",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "resources": ["arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"],
    "detail": {
        "catalog": "AWS",
        "engagementInvitation": {
            "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
            "id": "engi-v7p8z56whnauo",
            "engagementId": "eng-12356whnauo",       
            "participantType": "Enum", //Sender/Receiver
            "senderAccountId": "string",
            "receiverAccountId": "string",
            "payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation
        }
    }
}

참여 초대 거부됨

파트너는이 이벤트를 사용하여 다음을 수행합니다.

사용자에게 EngagementInvitation이 거부되었음을 알립니다.
거부된 초대를 반영하도록 내부 레코드를 업데이트합니다.
영업 팀에 거부 사실을 알리는 등 필요한 워크플로를 트리거합니다.

다음 예제에서는 일반적인 참여 초대 거부 이벤트를 보여줍니다.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Rejected",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-17T09:48:27Z",
    "region": "us-east-1",
    "resources": ["arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"],
    "detail": {
        "catalog": "AWS",
        "engagementInvitation": {
            "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
            "id": "engi-v7p8z56whnauo",
            "engagementId": "eng-12356whnauo",
            "participantType": "Enum", //Sender/Receiver
            "senderAccountId": "string",
            "receiverAccountId": "string",    
            "payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation 
        } 
    }
}

참여 초대 만료됨

파트너는이 이벤트를 사용하여 다음을 수행합니다.

사용자에게 EngagementInvitation이 만료되어 더 이상 조치를 취할 수 없음을 알립니다.
만료된 초대를 반영하도록 내부 레코드를 업데이트합니다.
영업 팀에 만료된 초대에 대해 알리는 등 필요한 워크플로를 트리거합니다.

다음 예제에서는 일반적인 참여 초대 만료 이벤트를 보여줍니다.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Expired",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"
    ],
    "detail": {
      "catalog" : "AWS",    
      "engagementInvitation": {
        "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
        "id": "engi-v7p8z56whnauo",
        "engagementId": "eng-12356whnauo",        
        "participantType": "Enum", //Sender/Receiver
        "senderAccountId": "string",
        "receiverAccountId": "string",
        "payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation
      }  
    }
}

참여 구성원 추가됨

파트너는이 이벤트를 사용하여 다음을 수행합니다.

참여 멤버십 변경 사항을 사용자에게 알립니다.
새 참여 구성원을 반영하도록 내부 레코드를 업데이트합니다.
팀원에게 변경 사항을 알리는 등 필요한 워크플로를 트리거합니다.

다음 예제에서는 일반적인 참여 구성원 추가 이벤트를 보여줍니다.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Member Added",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-v7p8z56whnauo"
    ],
    "detail": {
      "catalog" : "AWS",
      "engagement": {
        "id": "eng-v7p8z56whnauo"
      },
      "engagementMember": {
        "accountId": "string",
        "companyName": "string"
      }
    }
}

참여 리소스 스냅샷 생성됨

파트너는이 이벤트를 사용하여 참여와 관련된 리소스의 변경 사항을 추적하고 CRM 시스템 업데이트 또는 영업 팀에 알리는 등 자동화된 워크플로를 트리거합니다. 스냅샷 템플릿에 따라 업데이트 유형이 결정됩니다.

OpportunitySummaryView

참여의 모든 구성원에게 참여 업데이트 사실을 알립니다.

AwsOpportunitySummaryFullView

AWS에서 특별히 수행한 업데이트를 참여 내의 기회로 추적합니다.
이 알림 및 스냅샷은 기회 소유자에게만 표시됩니다.
OpportunitySummaryView 템플릿을 통해 사용할 수 없는 거래 크기 조정 업데이트가 포함되어 있습니다.

다음 예제는 일반적인 참여 리소스 스냅샷 생성 이벤트를 보여줍니다.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Resource Snapshot Created",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-v7p8z56whnauo"
    ],
    "detail": {
      "catalog" : "AWS",
      "resourceSnapshot": {
        "arn": "arn:aws:partnercentral-selling:us-east-1::catalog/AWS/engagement/eng-v7p8z56whnauo/resource/Opportunity/o-12312/template/temp-name/snapshot/snapshot-19232",
        "engagementId": "eng-v7p8z56whnauo",
        "resourceType": "Opportunity",      
        "resourceId" : "O123211231",
        "createdBy": "123123123123",
        "targetMemberAccounts": ["123123123123", "aws"], 
        "resourceSnapshotTemplateName": "temp-name"
      }
    }
}

참여 생성됨

파트너는이 이벤트를 사용하여 다음을 수행합니다.

사용자에게 새 참여가 생성되었음을 알립니다.
CRM 시스템 업데이트 또는 영업 팀에 새 참여 생성에 대한 알림과 같은 자동화된 워크플로를 트리거합니다.

다음 예제는 일반적인 참여 생성 이벤트를 보여줍니다.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Created",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo"
    ],
    "detail": {
        "catalog": "AWS",
        "engagement": {
            "engagementArn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo",
            "engagementId": "eng-567a1j5hxp35lo",
            "CreatedAt": "2023-04-18T18:20:15Z",
            "CreatedBy": "aws",
            "ContextTypes": ["Lead"]
            
        }
    }
}

참여 업데이트됨

파트너는이 이벤트를 사용하여 다음을 수행합니다.

기존 계약이 업데이트되었음을 사용자에게 알립니다.
CRM 시스템 업데이트 또는 영업 팀에 알리는 등의 자동화된 워크플로를 트리거합니다.

다음 예제에서는 일반적인 참여 업데이트 이벤트를 보여줍니다.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Updated",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo"
    ],
    "detail": {
        "catalog": "AWS",
        "engagement": {
            "engagementArn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo",
            "engagementId": "eng-567a1j5hxp35lo",
            "LastModifiedAt": "2023-04-18T18:20:15Z",
            "LastModifiedBy": "aws",
            "ContextTypes": ["Lead", "CustomerProject"]
        }
    }
}

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AWS파트너 중앙 계정 API에 대한 알림

AWS Partner Central Benefits API에 대한 알림