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 all'integrazione delle applicazioni, puoi creare integrazioni utili per soddisfare le esigenze della tua attività. Per ulteriori informazioni, consulta Utilizzare le sottoscrizioni agli eventi nelle integrazioni

.

Attivare le iscrizioni agli eventi nelle connessioni

Un collegamento creato può essere utilizzato per una delle seguenti finalità:

  • Solo per l'esecuzione di operazioni del connettore (entità e azioni)
  • Solo per le iscrizioni agli eventi
  • Per eseguire operazioni del connettore e iscrizioni agli eventi

L'opzione per attivare le sottoscrizioni agli eventi e configurare i dettagli relativi agli eventi è disponibile durante la creazione della connessione. Tuttavia, se hai già una connessione esistente e vuoi riutilizzarla per l'iscrizione agli eventi, puoi farlo 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 in una risposta alla notifica di evento. Le informazioni aggiuntive sono specifiche 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 visualizzare questi dettagli aggiuntivi dell'entità ticket, devi attivare l'arricchimento dei dati in una connessione Zendesk. Per maggiori informazioni, consulta Configurare l'iscrizione 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 della 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 l'iscrizione agli eventi

Per una maggiore sicurezza, puoi configurare la connettività privata tra l'applicazione di backend e la connessione. In caso di connettività privata, l'ascoltatore 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 al servizio PSC alla tua applicazione di backend utilizzando qualsiasi approccio adatto a te. Un possibile approccio è utilizzare il collegamento a un servizio PSC in un bilanciatore del carico e poi configurare il bilanciatore del carico in modo che accetti gli eventi dall'applicazione di backend. La connessione rimane in ascolto per gli 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 di importazione. Viene visualizzato il riquadro Impostazioni di sottoscrizione agli eventi.
  3. Copia il nome dell'allegato del servizio visualizzato nel campo Nome dell'allegato del servizio PSC.
  4. Crea un gruppo di endpoint di rete PSC che rimandi al collegamento del servizio ottenuto nel passaggio precedente.
  5. Crea un bilanciatore del carico esterno con il gruppo di endpoint di rete del PSC creato nel passaggio precedente come backend.
  6. Configura il bilanciatore del carico in modo che accetti le richieste dall'indirizzo IP del fornitore 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 di importazione. 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 alla connessione.

Utilizzare le iscrizioni agli eventi nelle integrazioni

Quando utilizzi le iscrizioni agli eventi insieme alle tue 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. L'integrazione delle applicazioni fornisce i seguenti attivatori che ascoltano le notifiche degli eventi dalle 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 di eventi nell'integrazione dell'applicazione, Integration Connectors crea una voce per la sottoscrizione 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 sul collegamento per cui vuoi visualizzare gli abbonamenti.

    Viene visualizzata la pagina Dettagli connessione.

  3. Fai clic sulla scheda Sottoscrizioni.

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

    • Creazione: l'abbonamento è in fase di creazione da parte di un'integrazione.
    • Attivo: l'abbonamento è valido e funzionante.
    • Sospesa: la connessione è in stato di sospensione.
    • Errore: la creazione dell'abbonamento non è andata a buon fine. ad esempio un errore di 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 verrà addebitato il costo per i dati delle iscrizioni agli eventi elaborati in attivatori disponibili a livello generale.