Iscrizioni a eventi

Oltre a consentirti di eseguire operazioni di lettura e scrittura sul tuo backend, Integration Connectors consentono di effettuare la sottoscrizione agli eventi che si verificano nelle applicazioni di backend. Ad esempio, considera vuoi ricevere una notifica quando viene creato un nuovo ticket Jira. Puoi farlo configurando il connettore Cloud Jira per le sottoscrizioni 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, vedi Utilizzare le iscrizioni agli eventi nelle integrazioni

Nota: se configuri una Perimetro di servizio VPC devi attivare la connettività privata per le sottoscrizioni agli eventi

nel tuo progetto Google Cloud.

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

È 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 sottoscrizioni agli eventi:

• Hubspot
• MQ IBM
• Jira
• MQ conigli
• ServiceNow
• TIBCOEM
• Webhook
• Zendesk

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 ottenere le informazioni aggiuntive, devi attivare l'arricchimento dei dati nella tua connessione.

Ad esempio, se hai effettuato l'iscrizione a un evento di creazione di biglietti in Zendesk, quando viene creato un ticket. Tuttavia, il payload di notifica degli eventi è costituito solo i dettagli di base dei ticket. Ulteriori dettagli come la descrizione del biglietto, l'assegnatario e lo stato non sono presenti nel payload. Per ottenere questi dettagli aggiuntivi ticket, devi abilitare l'arricchimento dei dati in una connessione Zendesk. Per ulteriori informazioni, vedi Configura la sottoscrizione agli eventi. La 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"
        }
      }
    }
  }
 }

.

Nota:

• Se hai abilitato l'arricchimento dei dati, il payload contiene il campo context-data oltre alla normale risposta che dovresti senza l'arricchimento dei dati. Nell'esempio precedente, il valore Il campo context-data contiene ulteriori dettagli sul ticket appena creato in Zendesk.
• Solo lo strumento Zendesk supporta l'arricchimento dei dati per le notifiche degli eventi.

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 consenti il traffico di rete in entrata verso il listener di eventi tramite il collegamento di un 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. 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 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 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.
   Suggerimento: se hai già un bilanciatore del carico esterno, puoi utilizzarlo per configurare la connettività privata anziché crearne una nuova.
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 registrazione automatica dell'iscrizione all'evento. 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 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 iniziare 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:

• Trigger HubSpot: ascolta gli eventi HubSpot.
• Trigger IBM MQ: ascolta gli eventi IBM MQ.
• Trigger Cloud Jira: rimane in ascolto degli eventi Cloud Jira.
• Trigger MQ Rabbit: ascolta gli eventi Rabbit MQ.
• Trigger di ServiceNow: ascolta gli eventi ServiceNow.
• Trigger TIBCOEMS: ascolta gli eventi TIBCOEMS.
• Trigger webhook: ascolta gli eventi webhook generici.
• Trigger Zendesk: ascolta gli eventi Zendesk.

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

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 questo pagina può essere 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.

Nota: se per una connessione sono attive iscrizioni a eventi, non può eliminare la connessione né modificare il nome host o l'indirizzo IP della connessione del backend.

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 relativi alle iscrizioni agli eventi elaborati in un trigger in disponibilità generale.