Langganan acara

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

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

Mengaktifkan langganan peristiwa di koneksi

Koneksi yang Anda buat dapat digunakan untuk salah satu tujuan berikut:

• Hanya untuk melakukan operasi konektor (entity dan tindakan)
• Khusus untuk langganan acara
• Untuk melakukan 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:

• Apache Kafka
• HubSpot
• IBM MQ
• Jira Cloud
• Rabbit MQ
• Gateway SAP
• SAP ERP
• ServiceNow
• Solace
• TIBCOEMS
• Webhook
• Zendesk

Pengayaan data dalam notifikasi peristiwa

Anda dapat mengonfigurasi koneksi untuk menambahkan informasi tambahan dalam respons notifikasi peristiwa. Informasi tambahan khusus untuk entitas yang peristiwanya telah Anda konfigurasikan. Untuk mendapatkan informasi tambahan, Anda harus mengaktifkan Penambahan nilai data di koneksi Anda.

Misalnya, jika Anda telah berlangganan peristiwa pembuatan tiket di Zendesk, Anda akan diberi tahu saat tiket dibuat. Namun, payload notifikasi peristiwa hanya berisi detail tiket dasar. Detail tambahan seperti deskripsi tiket, penerima tugas, dan status tidak ada dalam payload. Untuk mendapatkan detail tambahan entity ticket ini, Anda harus mengaktifkan pengayaan data di 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 pembuatan tiket 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 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 tiket yang baru dibuat di Zendesk.
• Hanya konektor Zendesk yang mendukung pengayaan data untuk notifikasi peristiwa.

Konektivitas pribadi untuk langganan acara

Untuk keamanan yang ditingkatkan, 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 diberikan kepada Anda oleh Konektor Integrasi.

Selama pembuatan koneksi, jika Anda telah memilih Enable private connectivity untuk langganan peristiwa, Konektor Integrasi akan membuat lampiran layanan PSC. Anda harus mengekspos lampiran layanan PSC ke aplikasi backend menggunakan pendekatan apa pun yang sesuai untuk Anda. Salah satu pendekatan yang mungkin dilakukan adalah menggunakan lampiran layanan PSC di 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 traffic masuk. Tindakan ini akan menampilkan panel Setelan langganan peristiwa.
3. Salin nama lampiran layanan seperti yang ditampilkan di kolom PSC service attachment name.
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) Anda.

   Langkah-langkah 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 traffic masuk. Tindakan ini akan menampilkan panel Setelan langganan peristiwa.
9. Masukkan alamat load balancer di kolom Endpoint ingress pemroses peristiwa.
10. Klik Done.
11. Klik Simpan untuk menyimpan perubahan pada koneksi.

Menggunakan langganan peristiwa dalam integrasi Anda

Saat menggunakan subscription peristiwa bersama dengan integrasi, Anda dapat membuat integrasi untuk memecahkan masalah bisnis yang kompleks. Misalnya, Anda dapat memulai eksekusi seluruh integrasi berdasarkan peristiwa ServiceNow. Integrasi Aplikasi menyediakan pemicu berikut yang memproses notifikasi peristiwa dari aplikasi backend Anda:

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

Untuk mengonfigurasi pemicu, Anda harus mengaktifkan langganan peristiwa untuk koneksi. Anda dapat mengaktifkan langganan peristiwa di koneksi yang ada, atau di koneksi baru. Untuk mengetahui langkah-langkah mendetail tentang cara mengonfigurasi pemicu Integrasi Aplikasi ini, lihat dokumentasi pemicu yang sesuai.

Lihat langganan yang aktif

Saat Anda menggunakan langganan peristiwa dalam integrasi aplikasi, Konektor Integrasi akan membuat entri untuk langganan di 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 Koneksi

2. Klik koneksi yang langganannya ingin Anda lihat.

   Tindakan ini akan membuka halaman Detail Koneksi.

3. Klik tab Langganan.

   Tindakan ini akan menampilkan semua langganan untuk koneksi. Langganan yang tercantum di halaman ini dapat berada dalam salah satu status berikut:

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

Catatan: Jika koneksi memiliki langganan peristiwa yang aktif, Anda tidak dapat menghapus koneksi, 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 akan ditagih. Namun, Anda akan ditagih untuk data langganan peristiwa yang diproses dalam pemicu yang tersedia secara umum.