Configurazione di notifiche in tempo reale per AWS Partner Central ed Marketplace AWS eventi - AWS Partner Central

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à.

Configurazione di notifiche in tempo reale per AWS Partner Central ed Marketplace AWS eventi

I seguenti argomenti spiegano come configurare EventBridge le notifiche in tempo reale per AWS Partner Central e Marketplace AWS gli eventi. Puoi configurare le notifiche in Salesforce configurando un'app connessa oppure puoi utilizzare modelli. AWS CloudFormation

Configurazione di un'app connessa a Salesforce

I passaggi seguenti spiegano come configurare un'app connessa in Salesforce. È necessario creare un'app connessa per utilizzare l' OAuth autenticazione per le connessioni di destinazione. Per ulteriori informazioni, fare riferimento aCreazione manuale dei componenti di notifica, più avanti in questa guida.

  1. Accedi alla tua organizzazione Salesforce come amministratore di sistema.

  2. Da Configurazione, nella casella Ricerca rapida, inserisciapps, quindi seleziona App Manager.

  3. Nella pagina Lightning Experience App Manager, scegli Nuova app connessa, scegli Crea un'app connessa, quindi scegli Continua.

    Viene visualizzata la pagina Nuova app connessa.

  4. Esegui questa operazione:

    1. Nella casella Nome app connessa, inserisci un nome per l'app.

    2. Nella casella Email di contatto, inserisci il tuo indirizzo e-mail.

    3. (Facoltativo) Completa i campi rimanenti come descritto in Configurazione delle impostazioni di base delle app connesse, nella documentazione di Salesforce.

  5. Seleziona la casella di controllo Abilita OAuth impostazioni, quindi procedi come segue:

    1. Seleziona la casella di controllo Abilita per Device Flow. Puoi ignorare l'URL di callback risultante.

    2. In OAuth Ambiti disponibili, seleziona Gestisci i dati utente tramite APIs e utilizza il pulsante Aggiungi per spostare l'ambito nell'elenco degli ambiti selezionati.

    3. Seleziona le seguenti caselle di controllo:

      • Richiedi l'estensione Proof Key for Code Exchange (PKCE) per i flussi di autorizzazione supportati

      • Richiedi Secret for Web Server Flow

      • Richiedi segreto per Refresh Token Flow

      • Abilita il flusso delle credenziali del client

    4. Nel messaggio che appare dopo aver selezionato Enable Client Credentials Flow, scegli OK.

    5. Scorri fino in fondo alla pagina e scegli Save (Salva).

  6. Scegli Continua, quindi scegli Gestisci i dettagli del consumatore.

    Viene visualizzata la pagina Verifica la tua identità e il sistema invia un codice di verifica al tuo indirizzo email di contatto.

  7. Inserisci il codice di verifica nella casella Codice di verifica e scegli Verifica.

    Viene visualizzata la pagina dell'app connessa.

  8. In Consumer Details, scegli i pulsanti Copia per la chiave consumer e il segreto del cliente.

  9. Da Configurazione, nella casella Ricerca rapida, inserisci App, seleziona Gestisci app connesse, quindi scegli l'app connessa che hai appena creato.

  10. Scegli Modifica politiche, quindi procedi come segue:

    1. Dall'elenco Utenti consentiti, seleziona Tutti gli utenti possono autorizzarsi autonomamente.

    2. Dall'elenco IP Relaxation, scegli Applica restrizioni IP.

    3. Dall'elenco RunAs, selezionate l'utente di esecuzione, l'utente a cui assegnate il flusso di credenziali del client. Salesforce richiede all'utente di esecuzione di restituire i token di accesso per conto dell'utente.

    4. Scegli Save (Salva).

Utilizzo di uno AWS CloudFormation stack per configurare le notifiche

Negli argomenti seguenti viene illustrato come utilizzare AWS CloudFormation i modelli per configurare EventBridge le notifiche in tempo reale. I passaggi si applicano solo alla versione 3.0 e successive del connettore AWS Partner CRM.

Per la versione 3.0 e successive del connettore AWS Partner CRM, puoi utilizzare un AWS CloudFormation modello per configurare i AWS componenti per Amazon EventBridge Integration oppure puoi creare i componenti manualmente. Per utilizzarli AWS CloudFormation, scarica i modelli da:

Individuazione dell'URL del dominio

Il AWS CloudFormation modello utilizza l'URL del tuo dominio come uno dei parametri obbligatori.

Per trovare l'URL
  1. Accedi a Salesforce.

  2. Nella sezione Configurazione, nella casella Ricerca rapida, inserisci. my domain

  3. Nel riquadro di sinistra, in Impostazioni aziendali, scegli il link Il mio dominio.

  4. Copia l'indirizzo nella casella URL del mio dominio corrente.

Nota

È necessario utilizzare il prefisso https://quando si immette l'URL nel AWS CloudFormation modello.

Usare lo stack AWS CloudFormation

I passaggi descritti nei seguenti argomenti spiegano come creare e distribuire uno AWS CloudFormation stack che configura notifiche in tempo reale.

  1. Scarica i seguenti modelli:

    Nota

    Ogni modello viene distribuito separatamente e si seguono gli stessi passaggi per entrambi.

  2. Nella AWS Console, accedi al tuo Account Marketplace AWS venditore e assicurati che funzioni nella Virginia settentrionale. EventBridge opera solo in quella regione.

  3. Sempre nella console, cercacloudformation, quindi apri la AWS CloudFormation console.

  4. Nella pagina Pile, scegli Crea pila.

  5. Seleziona i pulsanti di opzione Scegli un modello esistente e Carica un file modello.

  6. Seleziona Scegli file per aprire il modello scaricato, quindi scegli Avanti.

  7. Nella pagina Specificare i dettagli dello stack, inserisci quanto segue:

    • Nome dello stack: inserisci un nome per lo stack.

    • ID cliente: inserisci la chiave utente che hai annotato durante la creazione dell'app connessa.

    • Client Secret: inserisci il segreto del consumatore che hai annotato quando hai creato l'app connessa.

    • URL del dominio: utilizza il seguente formato: https://domain_URL.

    Al termine, scegli Apply (Applica).

  8. Nella pagina Configura le opzioni dello stack, scorri fino alla fine, seleziona la casella di controllo Riconosco che AWS CloudFormation potrebbe creare risorse IAM, quindi scegli Avanti.

  9. Scegli Invia.

Una volta implementati correttamente, i modelli creano le API Destination, Connection, Event Rules e Dead Letter Queue.

Creazione manuale dei componenti di notifica

I passaggi seguenti spiegano come creare manualmente i componenti per EventBridge le notifiche.

Crea una destinazione e una connessione EventBridge API Amazon

Per creare una destinazione API e una connessione in EventBridge, crea una destinazione API che utilizzi una nuova connessione. In questo caso, la destinazione dell'API è una chiamata API REST a Salesforce per ripubblicare un evento. La connessione contiene le informazioni di autenticazione per la chiamata API. La connessione accetta diversi metodi di autorizzazione.

Prerequisiti

Per utilizzare l' OAuth autorizzazione per la connessione di destinazione dell'API, crea un'app connessa in Salesforce. Per farlo, segui i passaggi in Configurare un'app connessa per il flusso di credenziali del client OAuth 2.0, nella documentazione di Salesforce. Utilizzi la chiave consumer e il segreto dell'app connessa per la connessione di destinazione dell'API.

Per creare una destinazione API nella EventBridge console:

  • Segui la procedura descritta in Creare una destinazione API nella Amazon EventBridge User Guide.

  • Configura le configurazioni specifiche di Salesforce.

In Salesforce, nella pagina Il mio dominio, in Configurazione, annota il nome di dominio della tua organizzazione. Lo usi per configurare la destinazione e la connessione dell'API nella EventBridge console. I passaggi seguenti spiegano come.

Per creare la destinazione e la connessione
  1. Apri la EventBridge console all'indirizzo e https://console.aws.amazon.com/events/, nel riquadro di navigazione a sinistra, scegli Destinazioni API.

  2. Scorri verso il basso fino alla tabella delle destinazioni API e scegli Crea destinazione API.

    Viene visualizzata la pagina Crea destinazione API.

  3. Immetti le seguenti informazioni:

    1. Un nome per la destinazione dell'API. È possibile utilizzare fino a 64 lettere maiuscole o minuscole, numeri, punti (.), trattini (-) o caratteri di sottolineatura (_).

      Il nome deve essere univoco per l'account nella Regione corrente.

    2. (Facoltativo) Inserisci una descrizione della destinazione dell'API.

    3. Per l'endpoint di destinazione dell'API, usa questo URL:https://my-salesforce-domain-name.my.salesforce.com/services/data/v58.0/sobjects/event-api-name.

    4. Per Metodo HTTP seleziona POST.

  4. In Configurazione della connessione, seleziona Crea una nuova connessione, quindi procedi come segue:

    1. Inserisci un nome e una descrizione opzionale.

    2. Per Tipo di destinazione, scegli Altro.

    3. Scegli Credenziali OAuth client.

    4. Per l'endpoint di autorizzazione, accetta l'endpoint precompilato.

      - OPPURE -

      se utilizzi un'organizzazione di produzione, sostituisci l'endpoint popolato con questo URL:

      https://my-salesforce-domain-name.my.salesforce.com/services/oauth2/token

    5. Per Metodo HTTP seleziona POST.

    6. Per Client ID, inserisci la chiave consumer dall'app connessa in Salesforce.

    7. Per Client secret, inserisci il segreto del consumatore dall'app connessa in Salesforce.

    8. Aggiungi i seguenti valori: OAuth

      • Parametro: campo corporeo

      • Chiave: grant_type

      • Valore: client_credentials

  5. Scegli Create (Crea).

Nota

Se la tua organizzazione Salesforce utilizza l'autenticazione a più fattori per l'accesso alle API, gli utenti devono completare una seconda sfida di autenticazione per accedere a Salesforce. APIs Per ulteriori informazioni, consulta Impostare i requisiti di accesso all'autenticazione a più fattori per l'accesso all'API nella documentazione di Salesforce.

Dopo aver creato la destinazione dell'API, puoi creare una regola che utilizza la destinazione come destinazione.

Creazione di una EventBridge regola e connessione alla destinazione dell'API

EventBridge le regole instradano gli eventi dal bus degli eventi alla destinazione dell'API, il che comporta l'esecuzione di una chiamata REST per pubblicare un evento su Salesforce.

Per ulteriori informazioni sulle EventBridge regole, consulta la sezione Creazione di EventBridge regole Amazon che reagiscono agli eventi nella Amazon EventBridge User Guide.

Creazione di eventi relativi ai set di modifiche

I passaggi seguenti spiegano come creare eventi del set di modifiche.

  1. In Amazon EventBridge, scegli Regole.

  2. Dall'elenco, seleziona il bus dell'evento desiderato.

  3. Nella sezione Rules (Regole), scegli Create rule (Crea regola).

  4. Inserisci un nome per la regola, quindi scegli Avanti.

  5. In Schema di eventi, seleziona Modelli personalizzati (editor JSON) e inserisci il seguente filtro. Puoi utilizzare qualsiasi combinazione di tipi di dettaglio.

    {   "source": [     "aws.marketplacecatalog"   ],   "detail-type": [     "Change Set Succeeded",     "Change Set Failed",     "Change Set Cancelled"   ] }

    Per ulteriori informazioni sulla corrispondenza dei modelli di eventi, consulta Filtraggio dei contenuti nei modelli di EventBridge eventi di Amazon nella AWS documentazione.

  6. Scegli Next (Successivo).

  7. In Seleziona obiettivi, in Target 1, seleziona la destinazione EventBridge dell'API.

  8. Dall'elenco, seleziona la destinazione API che hai appena creato.

  9. Espandere Additional settings (Impostazioni aggiuntive).

  10. In Configura Target Input, seleziona Input Transformer e Configura Input Transformer. Ciò garantisce che vengano inviati solo i campi degli eventi Salesforce della sezione dei dettagli dell'evento originale.

    Il percorso di input deve essere: 

    {   "Name": "$.detail-type",   "awsapn__Account_Number__c": "$.account",   "awsapn__EntityId__c": "$.detail.ChangeSetId" }

    Il modello deve essere: 

    {   "Name": Name,   "awsapn__Account_Number__c": awsapn__Account_Number__c,   "awsapn__EntityId__c": awsapn__EntityId__c }
  11. Scegli Avanti, quindi Avanti.

  12. Controlla la regola, quindi scegli Crea regola.

Nota

Per risolvere i problemi di una destinazione API, puoi utilizzare la console Amazon SQS per aggiungere una coda di lettere morte alla destinazione. La coda riceve i messaggi che non è stato possibile recapitare, più gli errori. Dalla console Amazon SQS, puoi controllare i messaggi in coda per individuare eventuali errori. Per ulteriori informazioni, consulta Utilizzo delle code di lettere non recapitate per elaborare eventi non recapitati in EventBridge e Ricezione ed eliminazione di un messaggio in Amazon SQS nella Amazon SQS User Guide.

Creazione di eventi relativi all'offerta rilasciata

I passaggi seguenti spiegano come creare eventi Offer Released.

  1. Nella EventBridge console Amazon, scegli regole.

  2. Seleziona il bus di eventi desiderato dall'elenco.

  3. Nella sezione Rules (Regole), scegli Create rule (Crea regola).

  4. Inserisci un nome per la regola, quindi scegli Avanti.

  5. In Schema di eventi, seleziona Modelli personalizzati (editor JSON), quindi inserisci il seguente filtro: 

    {   "source": [     "aws.marketplacecatalog"   ],   "detail-type": [     "Offer Released"   ] }

    Per ulteriori informazioni sulla corrispondenza dei modelli di eventi, consulta Filtraggio dei contenuti nei modelli di EventBridge eventi Amazon nella Amazon EventBridge User Guide.

  6. Scegli Next (Successivo).

  7. In Seleziona obiettivi, in Target 1, seleziona la destinazione dell'EventBridge API, quindi apri l'elenco e seleziona la destinazione API che hai appena creato.

  8. Espandere Additional settings (Impostazioni aggiuntive).

  9. In Configure Target Input, seleziona Input Transformer e seleziona Configura Input Transformer. Questo passaggio impedisce l'invio a Salesforce dei campi degli eventi Amazon di primo livello. Viene inviata solo la parte contenente i campi degli eventi Salesforce della sezione dei dettagli dell'evento originale.

    Utilizza il seguente percorso di input: 

    {    "Name":"$.detail-type",    "awsapn__Account_Number__c":"$.account",    "awsapn__EntityId__c":"$.detail.offer.id",    "awsapn__Manufacturer_Account_Id__c":"$.detail.manufacturer.accountId",    "awsapn__Product_Id__c":"$.detail.product.id",    "awsapn__Seller_Account_Id__c":"$.detail.sellerOfRecord.accountId" }

    Usare il modello seguente: 

    {   "Name": Name,   "awsapn__Account_Number__c": awsapn__Account_Number__c,   "awsapn__EntityId__c": awsapn__EntityId__c,   "awsapn__Seller_Account_Id__c": awsapn__Seller_Account_Id__c,   "awsapn__Manufacturer_Account_Id__c": awsapn__Manufacturer_Account_Id__c,   "awsapn__Product_Id__c": awsapn__Product_Id__c }
  10. Scegli Avanti e poi Avanti.

  11. Controlla la regola, quindi scegli Crea regola.

Nota

Per facilitare la risoluzione dei problemi di esecuzione della destinazione dell'API, aggiungi una coda di lettere morte di Amazon SQS alla destinazione. La coda riceve i messaggi che non è stato possibile recapitare insieme agli errori. È quindi possibile interrogare i messaggi per visualizzare gli errori. Per ulteriori informazioni, consulta Event Retry policy e utilizzo delle code dead-letter e Ricezione ed eliminazione di messaggi (console) nella documentazione. AWS

Creazione di eventi di opportunità

Gli eventi di opportunità forniscono notifiche in tempo reale sui cambiamenti nello stato o nei dettagli delle opportunità

È inoltre possibile creare e gestire EventBridge le regole in modo programmatico utilizzando. AWS SDKs

Tipi di eventi

L'elenco seguente descrive i tipi di eventi generati quando i partner collaborano con le opportunità. I link rimandano alla documentazione dell'API per ogni evento.

Esempio di evento

{     "version": "1",     "id": ""d1example-0c9c-4655-15bf-c5exampleb08",     "source": "aws.partnercentral-selling",     "detail-type": "Opportunity Created",     "time": ""2023-10-28T13:31:05Z",     "region": ""us-east-1",     "account": ""123456789123",     "detail": {          "schemaVersion": "1",         "catalog": "AWS",         "opportunity": {             "identifier": ""O1234567",             "url": "Partner Central Opportunity Page URL"         }     } }

Regole di esempio

La tabella seguente elenca alcuni esempi delle EventBridge regole che è possibile utilizzare con gli eventi elencati nella sezione precedente. Le regole instradano gli eventi dal bus degli eventi alla destinazione dell'API, il che comporta l'esecuzione di una chiamata REST per pubblicare un evento su Salesforce.

Tipo di evento

Esempio

Opportunità creata

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

Opportunità aggiornata

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

Invito di fidanzamento creato

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

Invito di fidanzamento accettato

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

Invito di fidanzamento rifiutato

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

Tutti gli eventi

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