L' AWS Partner Central API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[AWS Partner Central API Reference.](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# 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.
**Topics**
+ [Completa il prerequisito per monitorare gli eventi](#events-prerequites)
+ [Configura Amazon EventBridge per monitorare gli eventi](#eventbridge-setup)
+ [Scopri di più sulla vendita di eventi API](#learn-about-events)
## 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-conditions.html#events-pattern-detail-type) 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'`AllowPutRuleForPartnercentralSellingEvents`istruzione consente la creazione di regole, ma solo per gli eventi dall'`aws.partnercentral-selling`origine.
------
#### [ 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) 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, [PutRule](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html)consulta *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](#opportunity-created): attivata quando viene creata una nuova opportunità.
+ [Opportunità aggiornata](#opportunity-updated): attivata quando un'opportunità (opportunità o il relativo riepilogo dell'AWS opportunità) viene aggiornata.
+ [Invito al coinvolgimento creato](#engagement-invitation-created): attivato quando viene creato un invito AWS di presentazione.
+ [Invito al coinvolgimento accettato](#engagement-invitation-accepted): si attiva quando un partner accetta un invito al AWS coinvolgimento, confermando il proprio interesse a collaborare all'opportunità.AWS
+ [Invito di fidanzamento rifiutato](#engagement-invitation-rejected): si attiva quando un partner rifiuta un invito di fidanzamento.AWS
+ [Invito al coinvolgimento scaduto](#engagement-invitation-expired): Questo evento viene attivato quando un partner rifiuta un. EngagementInvitation Notifica al partner mittente e ricevente che l'invito è scaduto.
+ [Membro di coinvolgimento aggiunto](#engagement-member-added): 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](#engagement-resource-snapshot-created): 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](#engagement-created): attivato quando viene creato un nuovo coinvolgimento.
+ [Engagement aggiornato](#engagement-updated): 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.
**Topics**
+ [Opportunità creata](#opportunity-created)
+ [Opportunità aggiornata](#opportunity-updated)
+ [Invito di fidanzamento creato](#engagement-invitation-created)
+ [Invito di fidanzamento accettato](#engagement-invitation-accepted)
+ [Invito di fidanzamento rifiutato](#engagement-invitation-rejected)
+ [Invito di fidanzamento scaduto](#engagement-invitation-expired)
+ [Membro di coinvolgimento aggiunto](#engagement-member-added)
+ [Istantanea della risorsa di coinvolgimento creata](#engagement-resource-snapshot-created)
+ [Engagement creato](#engagement-created)
+ [Engagement aggiornato](#engagement-updated)
#### 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": "{{}}",
"catalog": "{{}}",
"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": "{{}}",
"catalog": "{{}}",
"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"]
}
}
}
```