Iscrizioni a eventi

Oltre a consentirti di eseguire operazioni di lettura e scrittura sul tuo backend, Integration Connectors consente anche di sottoscrivere eventi che si verificano nelle tue applicazioni di backend. Ad esempio, considera di voler ricevere una notifica quando viene creato un nuovo ticket Jira. A questo scopo, puoi configurare il connettore Jira Cloud per le sottoscrizioni agli eventi. Utilizzando gli abbonamenti agli eventi insieme a Application Integration, puoi creare integrazioni utili per soddisfare le tue esigenze aziendali. Per maggiori informazioni, consulta Utilizzare le iscrizioni agli eventi nelle integrazioni

Abilita le iscrizioni agli eventi nelle connessioni

Una connessione creata può essere utilizzata per i seguenti scopi:

  • Solo per eseguire operazioni del connettore (entità e azioni)
  • Solo per iscrizioni a eventi
  • Per eseguire operazioni dei connettori e sottoscrizioni agli eventi

L'opzione per abilitare le sottoscrizioni agli eventi e configurare i relativi dettagli è disponibile durante la creazione della connessione. Tuttavia, se hai già una connessione esistente e vuoi riutilizzarla per la sottoscrizione all'evento, puoi farlo modificando e riconfigurando la connessione.

I seguenti connettori supportano le sottoscrizioni agli eventi:

Arricchimento dei dati nelle notifiche di eventi

Puoi configurare una connessione per aggiungere ulteriori informazioni in una risposta alla notifica di un evento. Le informazioni aggiuntive sono specifiche dell'entità per la quale hai configurato l'evento. Per ottenere le informazioni aggiuntive, devi abilitare l'arricchimento dei dati nella tua connessione.

Ad esempio, se hai effettuato l'iscrizione a un evento di creazione di biglietti in Zendesk, riceverai una notifica quando viene creato un ticket. Tuttavia, il payload della notifica degli eventi consiste solo dei dettagli di base dei ticket. Ulteriori dettagli come la descrizione del ticket, l'assegnatario e lo stato non sono presenti nel payload. Per ottenere questi dettagli aggiuntivi dell'entità ticket, devi abilitare l'arricchimento dei dati in una connessione Zendesk. Per maggiori informazioni, consulta Configurare la sottoscrizione agli eventi. Gli esempi riportati di seguito mostrano il payload della risposta senza e con l'arricchimento dei dati.

Payload senza arricchimento dei dati

L'esempio seguente mostra il payload di risposta dell'evento di creazione ticket di Zendesk senza arricchimento dei dati.

{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }

Payload con arricchimento dei dati

L'esempio seguente mostra il payload di risposta dell'evento di creazione ticket di Zendesk con l'arricchimento dei dati.

{
    "context-data": {
    "AllowChannelback": false,
    "Assignee": null,
    "AssigneeId": 1.6696812051473E13,
    "Brand": null,
    "BrandId": 1.6696812163985E13,
    "Cc": null,
    "CollaboratorIds": null,
    "Commenter": null,
    "HasAttachment": null,
    "CreatedAt": "2023-07-08 11:37:19.0",
    "CustomFields": null,
    "Description": "Test desc 2",
....
....
    "Status": "open",
    "Subject": "Test Zendesk Ticket Created -2 -DA",
    "Submitter": null,
    "SubmitterId": 1.6696812051473E13,
    "Tags": "tag-changed-after-cache,ticket-created",
....
....
    "ViaChannel": "web",
    "ViaFollowupSourceId": null,
    "ViaSource": "{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}",
    "View_Id": null
  },
   "data":{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }
 }

Connettività privata per la sottoscrizione all'evento

Per una maggiore sicurezza, puoi configurare la connettività privata tra l'applicazione di backend e la connessione. Nella connettività privata, il listener di eventi della connessione non verrà reso pubblico direttamente. Devi invece consentire il traffico di rete in entrata verso il listener di eventi tramite il collegamento al servizio PSC che ti verrà fornito da Integration Connectors.

Durante la creazione della connessione, se hai selezionato Abilita connettività privata per la sottoscrizione all'evento, Integration Connectors crea un collegamento al servizio PSC. Devi esporre il collegamento del servizio PSC all'applicazione di backend utilizzando qualsiasi approccio adatto a te. Un approccio possibile è utilizzare il collegamento al servizio PSC in un bilanciatore del carico e quindi configurare il bilanciatore del carico in modo che accetti gli eventi dall'applicazione di backend. La connessione rimane quindi in ascolto degli eventi del backend all'indirizzo del bilanciatore del carico. I seguenti passaggi di alto livello mostrano come utilizzare un bilanciatore del carico per configurare la connettività privata:

  1. Vai alla pagina dei dettagli della connessione appena creata.
  2. Fai clic su Modifica endpoint in entrata. Viene visualizzato il riquadro Impostazioni di iscrizione all'evento.
  3. Copia il nome del collegamento al servizio come visualizzato nel campo Nome del collegamento del servizio PSC.
  4. Crea un gruppo di endpoint di rete PSC che punti al collegamento al servizio ricevuto nel passaggio precedente.
  5. Crea un bilanciatore del carico esterno con il gruppo di endpoint di rete PSC creato nel passaggio precedente come backend.
  6. Configura il bilanciatore del carico in modo che accetti le richieste dall'indirizzo IP del provider di eventi (applicazione di backend).

    I setps successivi (da 7 a 11) sono applicabili solo nei connettori il cui backend supporta la registrazione automatica dell'abbonamento agli eventi. Ad esempio, Zendesk e Jira.

  7. Vai alla pagina dei dettagli della connessione appena creata.
  8. Fai clic su Modifica endpoint in entrata. Viene visualizzato il riquadro Impostazioni di iscrizione all'evento.
  9. Inserisci l'indirizzo del bilanciatore del carico nel campo Endpoint in entrata del listener di eventi.
  10. Fai clic su Fine.
  11. Fai clic su Salva per salvare le modifiche alla connessione.

Utilizzare le iscrizioni agli eventi nelle integrazioni

Quando utilizzi gli abbonamenti agli eventi insieme alle integrazioni, puoi creare integrazioni per risolvere i problemi aziendali complessi. Ad esempio, puoi avviare l'esecuzione dell'intera integrazione in base a un evento ServiceNow. Application Integration fornisce i seguenti trigger che restano in ascolto delle notifiche degli eventi delle applicazioni di backend:

Per configurare i trigger, devi abilitare la sottoscrizione agli eventi per le connessioni. Puoi abilitare la sottoscrizione all'evento in una connessione esistente o in una nuova. Per la procedura dettagliata su come configurare questi trigger di Application Integration, consulta la documentazione dei trigger corrispondenti.

Visualizza gli abbonamenti attivi

Quando utilizzi una sottoscrizione all'evento nell'integrazione dell'applicazione, Integration Connectors crea una voce per l'abbonamento nella connessione corrispondente. Per visualizzare tutte le sottoscrizioni per una connessione, segui questi passaggi:

  1. Apri la pagina Tutte le connessioni per il tuo progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic sulla connessione per la quale vuoi visualizzare gli abbonamenti.

    Viene visualizzata la pagina Dettagli connessione.

  3. Fai clic sulla scheda Sottoscrizioni.

    Vengono visualizzati tutti gli abbonamenti relativi alla connessione. Un abbonamento elencato in questa pagina può trovarsi in uno dei seguenti stati:

    • Creazione in corso...: l'abbonamento viene creato tramite un'integrazione.
    • Attivo: l'abbonamento è valido e funzionante.
    • Sospesa: la connessione è in stato di sospensione.
    • Errore: la creazione dell'abbonamento non è riuscita. Ad esempio, errore di autenticazione durante la creazione dell'abbonamento.

Prezzi per l'abbonamento all'evento

I dati (payload evento) elaborati per le iscrizioni agli eventi negli attivatori dell'anteprima non vengono addebitati. Tuttavia, ti verranno addebitati i dati degli abbonamenti agli eventi elaborati in un trigger in disponibilità generale.