Notifiche per AWS API di vendita Partner Central

Gli eventi per l'API di vendita forniscono notifiche in tempo reale sui cambiamenti nello stato o nei dettagli delle opportunità. Questi eventi aiutano a mantenere i sistemi sincronizzati con AWS Partner Central e garantiscono risposte e aggiornamenti tempestivi.

Completa il prerequisito per monitorare gli eventi

Gli utenti richiedono le autorizzazioni IAM appropriate per accedere e gestire gli eventi pubblicati dall'API di vendita Partner Central. Per ulteriori informazioni sulle azioni, le risorse e le chiavi di condizione disponibili per EventBridge, consulta Using IAM policy conditions in Amazon EventBridge nella Amazon EventBridge User Guide. Una delle chiavi di condizione èevents:detail-type, che può essere utilizzata per definire le autorizzazioni per tipi di eventi specifici.

La seguente politica di esempio mostra come personalizzare e definire l'ambito delle autorizzazioni per gli eventi proposti. L'AllowPutRuleForPartnercentralSellingEventsistruzione consente la creazione di regole, ma solo per gli eventi dall'aws.partnercentral-sellingorigine.

JSON

{
  "Version":"2012-10-17",
  "Statement": {
    "Sid": "AllowPutRuleForPartnercentralSellingEvents",
    "Effect": "Allow",
    "Action": "events:PutRule",
    "Resource": "*",
    "Condition": {
      "ForAllValues:StringEquals": {
        "events:source": "aws.partnercentral-selling"
      }
    }
  }
}

Configura Amazon EventBridge per monitorare gli eventi

Per monitorare gli eventi API di vendita, crei una EventBridge regola che corrisponda agli eventi che desideri acquisire. Puoi utilizzare Console di gestione AWS o gli AWS SDK per creare e gestire le regole. Le sezioni seguenti spiegano come creare regole utilizzando entrambi i metodi. Indipendentemente dal metodo utilizzato, è necessario creare la regola nella us-east-1 regione Stati Uniti orientali (Virginia settentrionale).

Console di gestione AWS setup

Per configurare una EventBridge regola utilizzando il Console di gestione AWS, segui i passaggi in Creazione di regole che reagiscono agli eventi in Amazon EventBridge nella Amazon EventBridge User Guide. Quando crei la regola, devi impostare il bus degli eventi come predefinito e creare la regola nella us-east-1 regione Stati Uniti orientali (Virginia settentrionale).

Di seguito è riportato un esempio di regola relativa agli eventi:

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

AWS Configurazione SDK

Puoi utilizzare gli AWS SDK per creare e gestire EventBridge regole a livello di codice. Per ulteriori informazioni, PutRuleconsulta Amazon EventBridge API Reference.

L'esempio seguente utilizza l'AWS SDK per 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'])

Scopri di più sulla vendita di eventi API

Le sezioni seguenti descrivono i tipi di eventi dell'API di vendita, gli scenari che li attivano e gli esempi di eventi.

Event types (Tipi di evento)

Di seguito sono riportati i tipi di eventi e i relativi fattori scatenanti.

• Opportunità creata: attivata quando viene creata una nuova opportunità.

• Opportunità aggiornata: attivata quando un'opportunità (opportunità o il relativo riepilogo dell'AWS opportunità) viene aggiornata.

• Invito al coinvolgimento creato: attivato quando viene creato un invito AWS di presentazione.

• Invito al coinvolgimento accettato: si attiva quando un partner accetta un invito al AWS coinvolgimento, confermando il proprio interesse a collaborare all'opportunità.AWS

• Invito di fidanzamento rifiutato: si attiva quando un partner rifiuta un invito di fidanzamento.AWS

• Invito al coinvolgimento scaduto: Questo evento viene attivato quando un partner rifiuta un. EngagementInvitation Notifica al partner mittente e ricevente che l'invito è scaduto.

• Membro di coinvolgimento aggiunto: questo evento viene attivato quando un nuovo membro si unisce all'Engagement dopo aver accettato un invito. Notifica a tutti gli attuali membri dell'Engagement che il nuovo membro viene aggiunto all'Engagement.

• Istantanea della risorsa di coinvolgimento creata: questo evento viene attivato quando viene creata la nuova revisione dell'istantanea delle risorse (come le opportunità) associate a un coinvolgimento. Notifica a tutti i membri attuali dell'Engagement le modifiche alla risorsa associata Snapshot.

• Engagement creato: attivato quando viene creato un nuovo coinvolgimento.

• Engagement aggiornato: attivato quando viene aggiornato un coinvolgimento.

Scenari di eventi

La tabella seguente descrive come funzionano gli eventi in diversi scenari. Per questi scenari vengono fatte le seguenti ipotesi:

• AWSè anche un partner in questi scenari.

• ResourceSnapshotJobè configurato correttamente dal partner.

• I campi aggiornati sull'opportunità si trovano anche nel modello di opportunità per Resource Snapshot.

Azione da parte tua in qualità di partner	Eventi ricevuti	Tipo di partecipante
Crei un'opportunità	Opportunità creata
Si utilizza StartEngagementFromOpportunityTask per inviare un'opportunità	Opportunità aggiornata, coinvolgimento creato, istantanea della risorsa di coinvolgimento creata, membro del coinvolgimento aggiunto, invito al coinvolgimento creato
AWS approva l'opportunità presentata	Invito al coinvolgimento accettato, membro del coinvolgimento aggiunto, opportunità aggiornata, istantanea della risorsa di coinvolgimento creata
AWS rifiuta l'opportunità presentata	Invito al coinvolgimento rifiutato, opportunità aggiornata, istantanea della risorsa di coinvolgimento creata
Associate un'Marketplace AWS offerta a un'opportunità	Opportunità aggiornata
Associate una soluzione a un'opportunità	Opportunità aggiornata, istantanea della risorsa di coinvolgimento creata
Aggiorna un'opportunità	Opportunità aggiornata, creazione di Engagement Resource Snapshot (facoltativo se ResourceSnapshotJob è impostata e gli aggiornamenti del campo si trovano nel modello)
AWS aggiorna la tua opportunità	Opportunità aggiornata, istantanea della risorsa di coinvolgimento creata
Inviti un altro partner a un fidanzamento	Invito di fidanzamento creato	Mittente
Il tuo invito a partecipare a un impegno viene accettato da un partner	Invito di fidanzamento accettato, membro di fidanzamento aggiunto	Mittente
Il tuo invito a partecipare a un impegno viene rifiutato da un partner	Invito di fidanzamento rifiutato	Mittente
Il tuo invito a partecipare a un impegno non viene accolto da un partner per 15 giorni	Invito al fidanzamento scaduto	Mittente
Riceverai un invito da un altro partner a partecipare a un impegno	Invito di fidanzamento creato	Ricevitore
Accetti l'invito di un altro partner a partecipare a un impegno tramite StartEngagementByAcceptingInvitationTask	Invito al coinvolgimento accettato, membro del coinvolgimento aggiunto, opportunità creata, opportunità aggiornata, istantanea della risorsa di coinvolgimento creata	Destinatario
Rifiuti l'invito a partecipare a un impegno da parte di un altro partner	Invito di fidanzamento rifiutato	Destinatario
Non agite su invito a partecipare a un impegno proveniente da un altro partner per 15 giorni	Invito al fidanzamento scaduto	Destinatario
Crei un coinvolgimento	Engagement creato	Mittente
Aggiorna un impegno	Impegno aggiornato	Mittente, destinatario

Eventi di esempio

Le sezioni seguenti forniscono esempi degli eventi elencati in precedenza nella sezione precedente.

Argomenti

• Opportunità creata

• Opportunità aggiornata

• Invito di fidanzamento creato

• Invito di fidanzamento accettato

• Invito di fidanzamento rifiutato

• Invito di fidanzamento scaduto

• Membro di coinvolgimento aggiunto

• Istantanea della risorsa di coinvolgimento creata

• Engagement creato

• Engagement aggiornato

Opportunità creata

I partner utilizzano questo evento per:

• Notifica ai propri utenti che è stata creata una nuova opportunità.

• Attiva flussi di lavoro automatizzati come l'aggiornamento dei sistemi CRM o la notifica ai team di vendita della creazione di nuove opportunità.

L'esempio seguente mostra un tipico evento Opportunity Created.

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

Opportunità aggiornata

I partner utilizzano questo evento per:

• Notificare ai propri utenti che un'opportunità esistente è stata aggiornata.

• Attiva flussi di lavoro automatizzati come l'aggiornamento dei sistemi CRM o la notifica ai team di vendita.

L'esempio seguente mostra un tipico evento Opportunity Updated.

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

Invito di fidanzamento creato

I partner utilizzano questo evento per:

• Notifica ai propri utenti le novità EngagementInvitation che hanno ricevuto.

• Attiva flussi di lavoro automatizzati per accettare o rifiutare l'invito, ad esempio aggiornando i sistemi CRM o avvisando i team di vendita.

L'esempio seguente mostra un tipico evento 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
      }
    }
}

Invito di fidanzamento accettato

I partner utilizzano questo evento per:

• Notificare ai propri utenti che l' EngagementInvitation opzione è stata accettata.

• Aggiorna i loro registri interni in modo che rispecchino il nuovo partner dell'Engagement.

• Attiva flussi di lavoro automatizzati per sincronizzare i dati o notificare agli altri membri del team il nuovo membro di Engagement.

L'esempio seguente mostra un tipico evento Engagement Invitation Accepted.

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

Invito di fidanzamento rifiutato

I partner utilizzano questo evento per:

• Notificare ai propri utenti che il EngagementInvitation messaggio è stato rifiutato.

• Aggiorna i loro record interni in modo che riflettano l'invito rifiutato.

• Attiva tutti i flussi di lavoro necessari, ad esempio avvisando il team di vendita del rifiuto.

L'esempio seguente mostra un tipico evento Engagement Invitation Rejected.

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

Invito di fidanzamento scaduto

I partner utilizzano questo evento per:

• Notifica ai propri utenti che EngagementInvitation è scaduto e non è più possibile agire su di esso.

• Aggiorna i loro record interni in modo che riflettano l'invito scaduto.

• Attiva tutti i flussi di lavoro necessari, ad esempio avvisando il team di vendita dell'invito scaduto.

L'esempio seguente mostra un tipico evento Engagement Invitation Expired.

{
    "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 di coinvolgimento aggiunto

I partner utilizzano questo evento per:

• Notifica ai propri utenti le modifiche all'iscrizione a Engagement.

• Aggiorna i loro record interni in modo che rispecchino il nuovo membro di Engagement.

• Attiva tutti i flussi di lavoro necessari, ad esempio avvisando i membri del team delle modifiche.

L'esempio seguente mostra un tipico evento 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"
      }
    }
}

Istantanea della risorsa di coinvolgimento creata

I partner utilizzano questo evento per tenere traccia delle modifiche alle risorse associate a un coinvolgimento e attivare flussi di lavoro automatizzati, come l'aggiornamento dei sistemi CRM o la notifica ai team di vendita. Il modello di istantanea determina il tipo di aggiornamento:

OpportunitySummaryView

• Notifica a tutti i membri di un coinvolgimento che l'impegno è stato aggiornato.

AwsOpportunitySummaryFullView

• Tieni traccia degli aggiornamenti apportati specificamente da AWS alle opportunità nell'ambito di un coinvolgimento.

• Questa notifica e questa istantanea sono visibili solo al proprietario dell'opportunità.

• Include aggiornamenti sul dimensionamento delle offerte, che non sono disponibili tramite il OpportunitySummaryView modello.

L'esempio seguente mostra un tipico evento 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"
      }
    }
}

Engagement creato

I partner utilizzano questo evento per:

• Notifica ai propri utenti che è stato creato un nuovo Engagement.

• Attiva flussi di lavoro automatizzati come l'aggiornamento dei sistemi CRM o la notifica ai team di vendita di nuove creazioni di coinvolgimento.

L'esempio seguente mostra un tipico evento 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"]
            
        }
    }
}

Engagement aggiornato

I partner utilizzano questo evento per:

• Notifica ai propri utenti che un Engagement esistente è stato aggiornato.

• Attiva flussi di lavoro automatizzati come l'aggiornamento dei sistemi CRM o la notifica ai team di vendita.

L'esempio seguente mostra un tipico evento 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"]
        }
    }
}