Iscrizioni a eventi

Oltre a consentirti di eseguire operazioni di lettura e scrittura sul tuo backend, i connettori di integrazione ti consentono anche di iscriverti agli eventi che si verificano nelle tue applicazioni di backend. Ad esempio, supponiamo che tu voglia ricevere una notifica quando viene creato un nuovo ticket Jira. Puoi farlo configurando il connettore Jira Cloud per le iscrizioni agli eventi. Utilizzando le iscrizioni agli eventi insieme con Application Integration, puoi creare integrazioni utili per soddisfare le esigenze della tua attività. Per ulteriori informazioni, consulta Utilizzare le sottoscrizioni agli eventi nelle integrazioni

nel tuo progetto Google Cloud.

Attivare 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 del connettore e iscrizioni agli eventi

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

I seguenti connettori supportano le iscrizioni agli eventi:

Arricchimento dei dati nelle notifiche di eventi

Puoi configurare una connessione per aggiungere ulteriori informazioni nella risposta alla notifica di un evento. Le informazioni aggiuntive è specifica dell'entità per cui hai configurato l'evento. Per visualizzare le informazioni aggiuntive, devi attivare l'opzione Arricchimento dei dati nella connessione.

Ad esempio, se hai effettuato la registrazione per un evento di creazione di ticket in Zendesk, riceverai una notifica quando viene creato un ticket. Tuttavia, il payload della notifica evento è costituito solo dai dettagli di base della richiesta. Nel payload non sono presenti dettagli aggiuntivi come la descrizione del ticket, il suo assegnatario e il suo stato. Per ottenere questi dettagli aggiuntivi dell'entità ticket, devi attivare l'arricchimento dei dati in una connessione Zendesk. Per ulteriori informazioni, vedi Configura la sottoscrizione agli eventi. I seguenti esempi 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 della richiesta di Zendesk senza l'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 della risposta dell'evento di creazione della richiesta 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 al listener di eventi tramite un collegamento del servizio PSC che ti verrà fornito da Integration Connectors.

Durante la creazione della connessione, se hai selezionato Abilita la connettività privata per l'iscrizione agli eventi, Integration Connectors crea un collegamento del servizio PSC. Devi esporre il collegamento del servizio PSC all'applicazione di backend utilizzando qualsiasi approccio adatto a te. Uno possibile consiste nell'utilizzare il collegamento al servizio PSC in un bilanciatore del carico, quindi configurare per accettare 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 sottoscrizione agli eventi.
  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 punta al collegamento al servizio che hai ricevuto nel passaggio precedente.
  5. Crea un bilanciatore del carico esterno con la rete PSC gruppo di endpoint 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 passaggi successivi (da 7 a 11) sono applicabili solo ai connettori il cui backend supporta la registrazione automatica della sottoscrizione di 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 sottoscrizione agli eventi.
  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 apportate alla connessione.

Utilizzare le iscrizioni agli eventi nelle integrazioni

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

Per configurare gli attivatori, devi attivare la sottoscrizione agli eventi per le connessioni. Puoi attivare l'iscrizione agli eventi in una connessione esistente o in una nuova. Per la procedura dettagliata su come configurare questi attivatori di integrazione dell'applicazione, consulta la documentazione corrispondente.

Visualizza gli abbonamenti attivi

Quando utilizzi una sottoscrizione all'evento nell'integrazione delle applicazioni, Integration Connectors crea una voce relativa all'abbonamento nella connessione corrispondente. Per visualizzare tutti gli abbonamenti 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, l'autenticazione durante la creazione dell'abbonamento.

Prezzi per l'abbonamento agli eventi

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