Langganan acara

Selain memungkinkan Anda melakukan operasi baca dan tulis di backend, Integration Connectors juga memungkinkan Anda berlangganan peristiwa yang terjadi dalam aplikasi backend. Misalnya, Anda ingin mendapatkan notifikasi saat tiket Jira baru dibuat. Anda dapat melakukannya dengan mengonfigurasi konektor Cloud Jira untuk langganan peristiwa. Dengan menggunakan langganan peristiwa beserta Integrasi Aplikasi, Anda dapat membuat integrasi yang berguna untuk memenuhi kebutuhan bisnis Anda. Untuk informasi selengkapnya, lihat Menggunakan langganan acara dalam integrasi Anda

Catatan: Jika Anda menyiapkan perimeter layanan VPC untuk project Google Cloud, Anda harus mengaktifkan konektivitas pribadi untuk langganan acara.

Mengaktifkan langganan acara dalam koneksi

Koneksi yang Anda buat dapat digunakan untuk tujuan berikut:

• Hanya untuk menjalankan operasi konektor (entitas dan tindakan)
• Hanya untuk langganan acara
• Untuk menjalankan operasi konektor dan langganan peristiwa

Opsi untuk mengaktifkan langganan peristiwa dan mengonfigurasi detail terkait peristiwa tersedia untuk Anda selama pembuatan koneksi. Namun, jika sudah memiliki koneksi dan ingin menggunakannya kembali untuk langganan peristiwa, Anda dapat melakukannya dengan mengedit dan mengonfigurasi ulang koneksi.

Konektor berikut mendukung langganan peristiwa:

• HubSpot
• MQ IBM
• Jira
• MQ Kelinci
• ServiceNow
• Webhook
• Zendesk

Pengayaan data dalam notifikasi acara

Anda dapat mengonfigurasi koneksi untuk menambahkan informasi tambahan dalam respons notifikasi peristiwa. Informasi tambahan ini dikhususkan untuk entitas yang peristiwanya telah Anda konfigurasi. Untuk mendapatkan informasi tambahan, Anda harus mengaktifkan Pengayaan data dalam koneksi Anda.

Misalnya, jika telah berlangganan untuk acara pembuatan tiket di Zendesk, Anda akan diberi tahu saat tiket dibuat. Namun, payload notifikasi acara hanya terdiri dari detail tiket dasar. Detail tambahan seperti deskripsi tiket, penerima tugas, dan status tidak ada dalam payload. Untuk mendapatkan detail tambahan tentang entity ticket, Anda harus mengaktifkan pengayaan data dalam koneksi Zendesk. Untuk informasi selengkapnya, lihat Mengonfigurasi langganan peristiwa. Contoh berikut menunjukkan payload respons tanpa dan dengan pengayaan data.

Payload tanpa pengayaan data

Contoh berikut menunjukkan payload respons peristiwa tiket pembuatan Zendesk tanpa pengayaan 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"
        }
      }
    }
  }

Payload dengan pengayaan data

Contoh berikut menunjukkan payload respons peristiwa pembuatan tiket dari Zendesk dengan pengayaan data.

{
    "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"
        }
      }
    }
  }
 }

Catatan:

• Jika Anda telah mengaktifkan pengayaan data, payload respons akan berisi kolom context-data selain respons normal yang akan Anda dapatkan tanpa pengayaan data. Pada contoh sebelumnya, kolom context-data berisi detail tambahan untuk tiket yang baru dibuat di Zendesk.
• Hanya konektor Zendesk yang mendukung pengayaan data untuk notifikasi peristiwa.

Konektivitas pribadi untuk langganan acara

Untuk keamanan yang lebih baik, Anda dapat mengonfigurasi konektivitas pribadi antara aplikasi backend dan koneksi Anda. Dalam konektivitas pribadi, pemroses peristiwa koneksi Anda tidak akan dipublikasikan secara langsung. Sebagai gantinya, Anda harus mengizinkan traffic jaringan masuk ke pemroses peristiwa melalui lampiran layanan PSC yang akan disediakan untuk Anda oleh Integration Connectors.

Selama pembuatan koneksi, jika Anda telah memilih Aktifkan konektivitas pribadi untuk langganan acara, Integration Connectors akan membuat lampiran layanan PSC. Anda harus mengekspos lampiran layanan PSC ke aplikasi backend dengan menggunakan pendekatan apa pun yang sesuai bagi Anda. Salah satu pendekatan yang mungkin dilakukan adalah menggunakan lampiran layanan PSC dalam load balancer, lalu mengonfigurasi load balancer untuk menerima peristiwa dari aplikasi backend Anda. Koneksi kemudian memproses peristiwa backend Anda di alamat load balancer. Langkah-langkah tingkat tinggi berikut menunjukkan cara menggunakan load balancer untuk mengonfigurasi konektivitas pribadi:

1. Buka halaman detail koneksi dari koneksi yang baru dibuat.
2. Klik Edit endpoint masuk. Tindakan ini akan menampilkan panel Setelan langganan acara.
3. Salin nama lampiran layanan seperti yang ditampilkan di kolom Nama lampiran layanan PSC.
4. Buat grup endpoint jaringan PSC yang mengarah ke lampiran layanan yang Anda dapatkan di langkah sebelumnya.
5. Buat load balancer eksternal dengan grup endpoint jaringan PSC yang dibuat di langkah sebelumnya sebagai backend.
   Tips: Jika sudah memiliki load balancer eksternal, Anda dapat menggunakannya untuk mengonfigurasi konektivitas pribadi, bukan membuat yang baru.
6. Konfigurasikan load balancer untuk menerima permintaan dari alamat IP penyedia peristiwa (aplikasi backend).

   Set berikutnya (7 hingga 11) hanya berlaku di konektor yang backend-nya mendukung pendaftaran otomatis langganan peristiwa. Misalnya, Zendesk dan Jira.

7. Buka halaman detail koneksi dari koneksi yang baru dibuat.
8. Klik Edit endpoint masuk. Tindakan ini akan menampilkan panel Setelan langganan acara.
9. Masukkan alamat load balancer di kolom Event pemroses ingress endpoint.
10. Klik Done.
11. Klik Save untuk menyimpan perubahan pada koneksi.

Menggunakan langganan acara dalam integrasi Anda

Saat menggunakan langganan acara bersama dengan integrasi, Anda dapat membuat integrasi untuk menyelesaikan masalah bisnis yang kompleks. Misalnya, Anda dapat memulai eksekusi seluruh integrasi berdasarkan peristiwa ServiceNow. Application Integration menyediakan pemicu berikut yang memproses notifikasi peristiwa dari aplikasi backend Anda:

• Pemicu HubSpot - Memproses peristiwa HubSpot.
• Pemicu MQ IBM - Memproses peristiwa IBM MQ.
• Pemicu Jira Cloud - Memproses peristiwa Jira Cloud.
• Pemicu Rabbit MQ - Memproses peristiwa Rabbit MQ.
• Pemicu ServiceNow - Memproses peristiwa ServiceNow.
• Pemicu webhook - Memproses peristiwa webhook umum.
• Pemicu Zendesk - Memproses peristiwa Zendesk.

Untuk mengonfigurasi pemicu, Anda harus mengaktifkan langganan peristiwa untuk koneksi Anda. Anda dapat mengaktifkan langganan peristiwa dalam koneksi yang ada, atau dalam koneksi baru. Untuk langkah-langkah mendetail tentang cara mengonfigurasi pemicu Application Integration ini, lihat dokumentasi pemicu yang sesuai.

Lihat langganan yang aktif

Saat Anda menggunakan langganan peristiwa dalam integrasi aplikasi, Integration Connectors akan membuat entri untuk langganan dalam koneksi yang sesuai. Untuk melihat semua langganan untuk koneksi, lakukan langkah-langkah berikut:

1. Buka halaman semua Koneksi untuk project Google Cloud Anda.

   Buka halaman Connections

2. Klik koneksi yang ingin Anda lihat langganannya.

   Tindakan ini akan membuka halaman Connection Details.

3. Klik tab Langganan.

   Ini akan menampilkan semua langganan untuk koneksi. Langganan yang tercantum di halaman ini dapat memiliki salah satu status berikut:

   • Membuat - Langganan sedang dibuat dengan integrasi.
   • Aktif - Langganan valid dan berfungsi.
   • Ditangguhkan - Koneksi berada dalam status ditangguhkan.
   • Error - Pembuatan langganan gagal. Misalnya, kegagalan autentikasi selama pembuatan langganan.

Catatan: Jika koneksi memiliki langganan peristiwa aktif, Anda tidak dapat menghapus koneksi tersebut, atau mengedit nama host atau alamat IP backend koneksi.

Harga untuk langganan acara

Data (payload peristiwa) yang diproses untuk langganan peristiwa di pemicu pratinjau, tidak dikenai biaya. Namun, Anda akan dikenai biaya untuk data langganan peristiwa yang diproses di pemicu yang tersedia secara umum.