Preencha o pré-requisito para monitorar eventos Configure EventBridge a Amazon para monitorar eventos Saiba mais sobre a venda de eventos de API

Notificações para o AWS API de vendas da Central de Parceiros

Os eventos da API de vendas fornecem notificações em tempo real sobre mudanças no status ou nos detalhes das oportunidades. Esses eventos ajudam a manter seus sistemas sincronizados com o AWS Partner Central e ajudam a garantir respostas e atualizações oportunas.

Tópicos

Preencha o pré-requisito para monitorar eventos
Configure EventBridge a Amazon para monitorar eventos
Saiba mais sobre a venda de eventos de API

Preencha o pré-requisito para monitorar eventos

Os usuários precisam das permissões apropriadas do IAM para acessar e gerenciar eventos publicados pela API de vendas do Partner Central. Para obter mais informações sobre as ações, os recursos e as chaves de condição disponíveis para EventBridge, consulte Usando as condições da política do IAM na Amazon EventBridge no Guia EventBridge do usuário da Amazon. Uma das chaves de condição éevents:detail-type, que pode ser usada para definir o escopo de permissões para tipos específicos de eventos.

O exemplo de política a seguir demonstra como personalizar e definir o escopo das permissões para os eventos propostos. A AllowPutRuleForPartnercentralSellingEvents declaração permite a criação de regras, mas somente para eventos da aws.partnercentral-selling origem.

Configure EventBridge a Amazon para monitorar eventos

Para monitorar eventos da API de vendas, você cria uma EventBridge regra que corresponda aos eventos que você deseja capturar. Você pode usar os SDKs Console de gerenciamento da AWS ou os AWS SDKs para criar e gerenciar regras. As seções a seguir explicam como criar regras usando os dois métodos. Independentemente do método usado, você deve criar a regra na us-east-1 região Leste dos EUA (Norte da Virgínia).

Console de gerenciamento da AWS configuração

Para configurar uma EventBridge regra usando o Console de gerenciamento da AWS, siga as etapas em Criação de regras que reajam a eventos na Amazon EventBridge no Guia EventBridge do usuário da Amazon. Ao criar a regra, você deve definir o barramento de eventos como padrão e criar a regra na us-east-1 região Leste dos EUA (Norte da Virgínia).

Veja a seguir um exemplo de uma regra de evento:


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

AWS Configuração do SDK

Você pode usar os AWS SDKs para criar e gerenciar EventBridge regras de forma programática. Para obter mais informações, consulte PutRule o Amazon EventBridge API Reference.

O exemplo a seguir usa o AWS SDK para 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'])

Saiba mais sobre a venda de eventos de API

As seções a seguir descrevem os tipos de eventos da API de vendas, os cenários que os acionam e os exemplos de eventos.

Tipos de eventos

A seguir estão os tipos de eventos e seus gatilhos.

Oportunidade criada: acionada quando uma nova oportunidade é criada.
Oportunidade atualizada: acionada quando uma oportunidade (oportunidade ou seu resumo de AWS oportunidade correspondente) é atualizada.
Convite de engajamento criado: acionado quando um convite de AWS indicação é criado.
Convite de engajamento aceito: acionado quando um parceiro aceita um convite de AWS engajamento, confirmando seu interesse em colaborar com ele AWS na oportunidade.
Convite de noivado rejeitado: acionado quando um parceiro rejeita um convite de AWS noivado.
Convite de engajamento expirado: Este evento é acionado quando um parceiro rejeita um. EngagementInvitation Ele notifica o parceiro de envio e recebimento de que o convite expirou.
Membro do Engajamento Adicionado: Esse evento é acionado quando um novo membro se junta ao Engajamento após aceitar um convite. Ele notifica todos os membros atuais do Engajamento sobre a adição do novo membro ao Engajamento.
Criação do instantâneo do recurso de engajamento: Esse evento é acionado quando a nova revisão do instantâneo dos recursos (como oportunidades) associados a um contrato é criada. Ele notifica todos os membros atuais do Contrato sobre as alterações no recurso associado Snapshot.
Engajamento criado: acionado quando um novo engajamento é criado.
Engajamento atualizado: acionado quando um engajamento é atualizado.

Cenários de eventos

A tabela a seguir descreve como os eventos operam em diferentes cenários. As seguintes suposições são feitas para esses cenários:

AWS também é parceira nesses cenários.
ResourceSnapshotJobé configurado corretamente pelo parceiro.
Os campos atualizados sobre a oportunidade também estão no modelo de oportunidade do Resource Snapshot.

Ação de você como parceiro	Eventos recebidos	Tipo de participante
Você cria uma oportunidade	Oportunidade criada
Você usa `StartEngagementFromOpportunityTask` para enviar uma oportunidade	Oportunidade atualizada, engajamento criado, instantâneo do recurso de engajamento criado, membro do engajamento adicionado, convite de engajamento criado
AWS aprova sua oportunidade enviada	Convite de engajamento aceito, membro de engajamento adicionado, oportunidade atualizada, resumo do recurso de engajamento criado
AWS rejeita sua oportunidade enviada	Convite de engajamento rejeitado, oportunidade atualizada, resumo do recurso de engajamento criado
Você associa uma AWS Marketplace oferta a uma oportunidade	Oportunidade atualizada
Você associa uma solução a uma oportunidade	Oportunidade atualizada, resumo do recurso de engajamento criado
Você atualiza uma oportunidade	Oportunidade atualizada, captura instantânea do recurso de engajamento criada (opcional se `ResourceSnapshotJob` estiver configurada e as atualizações de campo estiverem no modelo)
AWS atualiza sua oportunidade	Oportunidade atualizada, resumo do recurso de engajamento criado
Você convida outro parceiro para um compromisso	Convite de engajamento criado	Remetente
Seu convite para participar de um compromisso é aceito por um parceiro	Convite de noivado aceito, membro de engajamento adicionado	Remetente
Seu convite para participar de um compromisso foi rejeitado por um parceiro	Convite de compromisso rejeitado	Remetente
Seu convite para participar de um compromisso não é aceito por um parceiro por 15 dias	O convite de noivado expirou	Remetente
Você recebe um convite de outro parceiro para participar de um compromisso	Convite de engajamento criado	Receptor
Você aceita o convite de outro parceiro para participar de um compromisso via `StartEngagementByAcceptingInvitationTask`	Convite de engajamento aceito, membro de engajamento adicionado, oportunidade criada, oportunidade atualizada, resumo do recurso de engajamento criado	Receptor
Você rejeita o convite para participar de um compromisso de outro parceiro	Convite de compromisso rejeitado	Receptor
Você não age sob convite para participar de um compromisso de outro parceiro por 15 dias	O convite de noivado expirou	Receptor
Você cria um engajamento	Engajamento criado	Remetente
Você atualiza um compromisso	Engajamento atualizado	Remetente, receptor

Eventos de exemplo

As seções a seguir fornecem exemplos dos eventos listados anteriormente na seção anterior.

Tópicos

Oportunidade criada
Oportunidade atualizada
Convite de engajamento criado
Convite de engajamento aceito
Convite de compromisso rejeitado
O convite de noivado expirou
Membro de engajamento adicionado
Criação de um instantâneo de recursos de engajamento
Engajamento criado
Engajamento atualizado

Oportunidade criada

Os parceiros usam esse evento para:

Notifique seus usuários de que uma nova oportunidade foi criada.
Acione fluxos de trabalho automatizados, como atualizar sistemas de CRM ou notificar as equipes de vendas sobre a criação de novas oportunidades.

O exemplo a seguir mostra um evento típico de criação de oportunidade.


{
    "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"
        }
    }
}

Oportunidade atualizada

Os parceiros usam esse evento para:

Notifique seus usuários de que uma oportunidade existente foi atualizada.
Acione fluxos de trabalho automatizados, como atualizar sistemas de CRM ou notificar equipes de vendas.

O exemplo a seguir mostra um evento típico de atualização de oportunidade.


{
    "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"
        }
    }
}

Convite de engajamento criado

Os parceiros usam esse evento para:

Notifique seus usuários sobre o novo que EngagementInvitation eles receberam.
Acione fluxos de trabalho automatizados para aceitar ou rejeitar o convite, como atualizar os sistemas de CRM ou notificar as equipes de vendas.

O exemplo a seguir mostra um evento típico de Engagement Invitation Created.


{
    "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
      }
    }
}

Convite de engajamento aceito

Os parceiros usam esse evento para:

Notifique seus usuários de que o EngagementInvitation foi aceito.
Atualize seus registros internos para refletir o novo parceiro no contrato.
Acione fluxos de trabalho automatizados para sincronizar dados ou notificar outros membros da equipe sobre o novo membro do Engagement.

O exemplo a seguir mostra um evento típico de convite de engajamento aceito.


{
    "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
        }
    }
}

Convite de compromisso rejeitado

Os parceiros usam esse evento para:

Notifique seus usuários de que o EngagementInvitation foi rejeitado.
Atualize seus registros internos para refletir o convite rejeitado.
Acione todos os fluxos de trabalho necessários, como notificar a equipe de vendas sobre a rejeição.

O exemplo a seguir mostra um evento típico de convite de engajamento rejeitado.


{
    "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 
        } 
    }
}

O convite de noivado expirou

Os parceiros usam esse evento para:

Notifique seus usuários de que o EngagementInvitation expirou e não pode mais ser usado.
Atualize seus registros internos para refletir o convite expirado.
Acione todos os fluxos de trabalho necessários, como notificar a equipe de vendas sobre o convite expirado.

O exemplo a seguir mostra um evento típico de convite de engajamento expirado.


{
    "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
      }  
    }
}

Membro de engajamento adicionado

Os parceiros usam esse evento para:

Notifique seus usuários sobre as mudanças na associação do Engagement.
Atualize seus registros internos para refletir o novo membro do Engagement.
Acione todos os fluxos de trabalho necessários, como notificar os membros da equipe sobre as mudanças.

O exemplo a seguir mostra um evento típico de Engagement Member Added.


{
    "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"
      }
    }
}

Criação de um instantâneo de recursos de engajamento

Os parceiros usam esse evento para rastrear mudanças nos recursos associados a um contrato e acionar fluxos de trabalho automatizados, como atualizar sistemas de CRM ou notificar equipes de vendas. O modelo de instantâneo determina o tipo de atualização:

OpportunitySummaryView

Notifique todos os membros de um contrato de que o contrato foi atualizado.

AwsOpportunitySummaryFullView

Acompanhe as atualizações feitas especificamente pela AWS para oportunidades dentro de um contrato.
Essa notificação e esse instantâneo só são visíveis para o proprietário da oportunidade.
Inclui atualizações de dimensionamento de negócios, que não estão disponíveis por meio do OpportunitySummaryView modelo.

O exemplo a seguir mostra um evento típico de Engagement Resource Snapshot Created.


{
    "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"
      }
    }
}

Engajamento criado

Os parceiros usam esse evento para:

Notifique seus usuários de que um novo engajamento foi criado.
Acione fluxos de trabalho automatizados, como atualizar sistemas de CRM ou notificar equipes de vendas sobre novas criações de engajamento.

O exemplo a seguir mostra um evento típico do Engagement Created.


{
    "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"]
            
        }
    }
}

Engajamento atualizado

Os parceiros usam esse evento para:

Notifique seus usuários de que um contrato existente foi atualizado.
Acione fluxos de trabalho automatizados, como atualizar sistemas de CRM ou notificar equipes de vendas.

O exemplo a seguir mostra um evento típico de Engagement Updated.


{
    "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"]
        }
    }
}

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Notificações para o AWS API de conta do Partner Central

Notificações para o AWS API de benefícios do Partner Central