Lihat konektor yang didukung untuk Integration Aplikasi.

Pemicu HubSpot

Pratinjau — HubSpot trigger

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Pemicu HubSpot adalah Pemicu Peristiwa Konektor yang memungkinkan Anda memanggil integrasi berdasarkan peristiwa HubSpot kustom yang telah Anda tentukan di instance HubSpot.

Penting: Konektor Integrasi adalah komponen Google Cloud yang dapat ditagih. Untuk mengetahui informasi tentang biaya dan tagihan penggunaan Integration Connectors, lihat Harga Integration Connectors.

Sebelum memulai

Jika Anda berencana membuat atau mengonfigurasi koneksi baru untuk pemicu HubSpot, pastikan Anda memiliki peran Identity and Access Management (IAM) berikut di project:

• Connector Admin (roles/connectors.admin)

Untuk mengetahui informasi tentang cara memberikan peran, lihat Mengelola akses.

Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk pemicu HubSpot:

• Application Integration Invoker (roles/integrations.integrationInvoker)

Untuk informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Jenis acara yang didukung

Dengan langganan webhook, Anda dapat memilih peristiwa yang akan diterima aplikasi Anda. Jenis langganan berikut didukung:

• deal.creation
• deal.propertyChange
• deal.deletion
• contact.creation
• contact.propertyChange
• contact.deletion

Untuk mengetahui daftar lengkap jenis peristiwa, lihat Langganan webhook.

Menambahkan pemicu HubSpot

Untuk menambahkan pemicu HubSpot ke integrasi Anda, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations

   Halaman Daftar Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi di panel Buat Integrasi.
   2. Pilih region untuk integrasi.
      Catatan: Drop-down Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   4. Klik Create.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
5. Klik dan tempatkan elemen pemicu HubSpot di editor integrasi.

Untuk mengonfigurasi pemicu HubSpot, Anda dapat menggunakan koneksi HubSpot yang ada di Konektor Integrasi, atau membuat koneksi HubSpot baru menggunakan opsi pembuatan koneksi inline.

Mengonfigurasi pemicu HubSpot menggunakan koneksi yang ada

Anda dapat mengonfigurasi pemicu HubSpot menggunakan koneksi HubSpot yang ada di Konektor Integrasi. Pemicu HubSpot adalah pemicu peristiwa konektor, sehingga Anda hanya dapat menggunakan koneksi HubSpot dengan langganan peristiwa yang diaktifkan untuk mengonfigurasi pemicu.

Untuk mengetahui informasi tentang cara mengonfigurasi pemicu HubSpot menggunakan koneksi HubSpot baru, lihat Mengonfigurasi pemicu HubSpot menggunakan koneksi baru

Untuk mengonfigurasi pemicu HubSpot menggunakan koneksi HubSpot yang ada, ikuti langkah-langkah berikut:

1. Klik elemen pemicu HubSpot di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Berikan detail konfigurasi berikut di halaman Editor Pemicu Peristiwa Konektor:
   1. Region: Pilih region koneksi HubSpot Anda.
   2. Koneksi: Pilih koneksi HubSpot yang ingin Anda gunakan.

      Integrasi Aplikasi hanya menampilkan koneksi HubSpot yang aktif dan mengaktifkan langganan peristiwa.

   3. Jenis peristiwa: Pilih jenis peristiwa yang ingin Anda gunakan untuk memicu integrasi. Untuk mengetahui daftar jenis peristiwa yang didukung, lihat jenis peristiwa yang didukung.
   4. Service Account: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu HubSpot.
4. Klik Selesai untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

Mengonfigurasi pemicu HubSpot menggunakan koneksi baru

Untuk mengonfigurasi pemicu HubSpot menggunakan koneksi HubSpot baru, ikuti langkah-langkah berikut:

1. Klik elemen pemicu HubSpot di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Lewati kolom Region.
4. Klik Connection, lalu pilih opsi Create Connection dari menu drop-down.
5. Selesaikan langkah-langkah berikut di panel Buat Koneksi:
   1. Pada langkah Lokasi, pilih lokasi untuk koneksi HubSpot baru:
      1. Region: Pilih region dari menu drop-down.
      2. Klik Berikutnya.
   2. Di bagian Connection Details, selesaikan tindakan berikut:
      1. Konektor: Pilih HubSpot dari menu drop-down Konektor yang tersedia.
      2. Versi konektor: Pilih versi Konektor dari menu drop-down versi yang tersedia.
      3. Di kolom Connection Name, masukkan nama untuk instance Connection.

         Nama koneksi harus memenuhi kriteria berikut:

         • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
         • Huruf harus berupa huruf kecil.
         • Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
         • Nama koneksi tidak boleh melebihi 49 karakter.
         • Untuk konektor yang mendukung langganan peristiwa, nama koneksi tidak boleh diawali dengan awalan "goog".
      4. Secara opsional, masukkan Description untuk instance koneksi.
      5. Service Account: Pilih akun layanan yang memiliki peran yang diperlukan.
      6. Untuk menggunakan koneksi untuk langganan peristiwa, pilih Aktifkan langganan peristiwa. Dengan memilih opsi ini, opsi berikut akan ditampilkan:
         • Aktifkan langganan peristiwa dengan entity dan tindakan: Pilih opsi ini untuk menggunakan koneksi untuk langganan peristiwa dan operasi konektor (entity dan tindakan).
         • Aktifkan hanya langganan peristiwa: Pilih opsi ini untuk menggunakan koneksi hanya untuk langganan peristiwa. Jika Anda memilih opsi ini, klik Berikutnya, lalu konfigurasi langganan peristiwa.
      7. Schema: Tentukan versi HubSpot API yang akan digunakan. HubSpotV4 adalah API baru.
      8. BrowsableSchemas: Properti ini membatasi skema yang dilaporkan ke sebagian skema yang tersedia. Misalnya, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
      9. Contacts Properties: Masukkan nama kolom yang dipisahkan koma dari entitas Contacts yang ingin Anda pilih dari operasi entitas List. Misalnya, fieldA, fieldB, fieldC
      10. Companies Properties: Masukkan nama kolom yang dipisahkan koma dari entity Companies yang ingin Anda pilih dari operasi entity List. Misalnya, fieldA, fieldB, fieldC
      11. Deals Properties: Masukkan nama kolom yang dipisahkan koma dari entitas Deals yang ingin Anda pilih dari operasi entitas List. Misalnya, fieldA, fieldB, fieldC
      12. Gunakan proxy: Centang kotak ini untuk mengonfigurasi server proxy untuk koneksi.
      13. Proxy Auth Scheme: Jenis autentikasi yang akan digunakan untuk mengautentikasi ke proxy ProxyServer.
      14. Pengguna Proxy: Nama pengguna yang akan digunakan untuk mengautentikasi ke proxy ProxyServer.
      15. Proxy Password: Sandi yang akan digunakan untuk mengautentikasi ke proxy ProxyServer.
      16. Proxy SSL Type: Jenis SSL yang akan digunakan saat terhubung ke proxy ProxyServer.
      17. Secara opsional, konfigurasikan Setelan node koneksi:
          • Jumlah node minimum: Masukkan jumlah minimum node koneksi.
          • Maximum number of nodes: Masukkan jumlah maksimum node koneksi.

          Node adalah unit (atau replika) koneksi yang memproses transaksi. Semakin banyak node yang diperlukan untuk memproses lebih banyak transaksi untuk koneksi, dan sebaliknya, semakin sedikit node yang diperlukan untuk memproses lebih sedikit transaksi. Untuk memahami pengaruh node terhadap harga konektor, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default, node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

      Catatan: Anda hanya dapat menyesuaikan nilai node koneksi jika merupakan pelanggan Bayar sesuai penggunaan.
      18. Secara opsional, klik + Tambahkan label untuk menambahkan label ke Koneksi dalam bentuk pasangan nilai kunci.
      19. Klik Berikutnya.
   3. Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
      1. Jenis Tujuan: Anda dapat menentukan detail tujuan sebagai alamat host atau lampiran layanan. Pilih salah satu jenis tujuan berikut:
         • Alamat host: Jika Anda ingin menentukan nama host atau alamat IP tujuan.
         • Lampiran layanan: Jika Anda ingin menentukan endpoint pribadi untuk alamat IP internal. Lampiran layanan memungkinkan Anda menyembunyikan alamat IP internal dari jaringan eksternal. Anda dapat membuat lampiran layanan di Google Cloud, dengan menggunakan fitur Private Service Connect. Untuk informasi tentang cara mengonfigurasi Private Service Connect, lihat Memublikasikan layanan terkelola.

         Berdasarkan pilihan jenis tujuan, masukkan alamat host atau nama lampiran layanan.

         Untuk memasukkan tujuan tambahan, klik +Tambahkan tujuan.

      2. Klik Berikutnya.
   4. Di bagian Authentication, masukkan detail autentikasi.
      1. Pilih Jenis autentikasi dan masukkan detail yang relevan.

         Jenis autentikasi berikut didukung oleh koneksi HubSpot:

         • Token Akses Aplikasi Pribadi: Pilih Secret Manager Secret yang berisi token akses aplikasi pribadi.

           Aplikasi pribadi memungkinkan Anda menggunakan API HubSpot untuk mengakses data tertentu dari akun HubSpot Anda. Anda dapat memberikan otorisasi atas apa yang dapat diminta atau diubah oleh setiap aplikasi pribadi di akun Anda, yang akan menghasilkan token akses yang unik untuk aplikasi pribadi Anda. Di aplikasi pribadi, pastikan Anda telah memberikan izin baca setidaknya ke cakupan berikut:

           • crm.schemas.line_items.read
           • crm.schemas.quotes.read
           • crm.schemas.deals.read
           • crm.schemas.companies.read
           • crm.schemas.custom.read
           • crm.schemas.contacts.read

           Untuk informasi selengkapnya, lihat Aplikasi pribadi.

      2. Klik Berikutnya.
   5. Jika Anda telah mengaktifkan langganan peristiwa, bagian Detail Langganan Peristiwa akan muncul di halaman pembuatan koneksi. Pada langkah Detail langganan peristiwa, berikan detail autentikasi yang akan digunakan untuk memvalidasi payload token HubSpot:
      1. Rahasia Klien: (Opsional) Pilih secret Secret Manager dari secret klien aplikasi pribadi Anda, dan versi secret yang sesuai dari drop-down Versi Secret.

      Untuk informasi selengkapnya, lihat Aplikasi pribadi.

      2. Pilih Aktifkan konektivitas pribadi untuk konektivitas aman antara aplikasi backend dan koneksi Anda. Jika memilih opsi ini, Anda harus melakukan langkah konfigurasi tambahan setelah membuat koneksi. Untuk mengetahui informasi selengkapnya, lihat Konektivitas pribadi untuk langganan peristiwa.
      3. Masukkan konfigurasi dead-letter. Jika Anda mengonfigurasi dead-letter, koneksi akan menulis peristiwa yang belum diproses ke topik Pub/Sub yang ditentukan. Masukkan detail berikut:
         1. Project ID dead-letter: Project ID Google Cloud tempat Anda mengonfigurasi topik dead-letter Pub/Sub.
         2. Topik dead-letter: Topik Pub/Sub tempat Anda ingin menulis detail peristiwa yang tidak diproses.
      4. Klik Berikutnya.
   6. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
   7. Klik Create.

Membuat dan mengedit langganan webhook

Untuk menyelesaikan konfigurasi langganan peristiwa, Anda harus mendaftarkan URL webhook dengan aplikasi HubSpot. Oleh karena itu, setelah pembuatan koneksi berhasil, lakukan langkah-langkah tambahan berikut:

1. Buka halaman detail koneksi dari koneksi yang baru dibuat, lalu salin URL webhook untuk langganan peristiwa. URL webhook diperlukan saat Anda membuat langganan webhook di langkah berikutnya.

   Gambar berikut menunjukkan kolom Events listener endpoint di halaman detail koneksi HubSpot:

   
2. Ikuti langkah-langkah untuk membuat dan mengedit langganan webhook di HubSpot.

Output pemicu

Pemicu HubSpot memerlukan waktu beberapa menit untuk menyelesaikan konfigurasi langganan peristiwa. Anda dapat melihat status langganan peristiwa di panel konfigurasi pemicu pada bagian Detail Langganan Peristiwa.

Pemicu HubSpot menunjukkan status langganan peristiwa menggunakan status berikut:

• Creating: Menunjukkan bahwa pemicu berlangganan langganan peristiwa.
• Active: Menunjukkan bahwa pemicu berhasil berlangganan langganan peristiwa.
• Error: Menunjukkan bahwa ada masalah dengan langganan peristiwa yang dikonfigurasi.

Selain status langganan peristiwa, bagian Detail Langganan Peristiwa juga menampilkan detail lainnya seperti wilayah koneksi, nama koneksi, nama langganan peristiwa, dan lainnya.

Gambar berikut menunjukkan contoh tata letak panel konfigurasi pemicu HubSpot:

Memicu variabel output

Untuk setiap peristiwa, pemicu HubSpot akan menghasilkan variabel output ConnectorEventPayload yang dapat Anda gunakan dalam tugas downstream. Variabel output dalam format JSON yang berisi skema payload HubSpot output.

Melihat langganan peristiwa

Untuk melihat dan mengelola semua langganan peristiwa yang terkait dengan koneksi di Konektor Integrasi, lakukan hal berikut:

1. Buka halaman Integration Connectors > Connections.

   Buka halaman Koneksi

2. Klik koneksi yang langganannya ingin Anda lihat.
3. Klik tab Langganan peristiwa.

   Tindakan ini akan menampilkan semua langganan peristiwa untuk koneksi.

Mengedit pemicu HubSpot

Anda dapat mengedit pemicu HubSpot untuk mengubah atau memperbarui konfigurasi koneksi dan detail langganan peristiwa.

Penting: Saat mengedit atau mengubah pemicu HubSpot, Anda dapat mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya dan dilampirkan ke pemicu, atau Anda dapat menghapusnya. Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan menggunakan langganan peristiwa tersebut.

Untuk mengedit pemicu HubSpot, ikuti langkah-langkah berikut:

1. Klik elemen pemicu HubSpot di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu HubSpot.
3. Lakukan tindakan berikut di halaman Editor Pemicu Peristiwa Konektor:
   1. Untuk mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya, klik Pertahankan, atau klik Hapus.
      Peringatan: Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan menggunakan langganan peristiwa tersebut. Tugas ini tidak dapat diurungkan.
   2. Perbarui konfigurasi koneksi dan detail langganan peristiwa sesuai keinginan.
   3. Klik Done.

Anda dapat melihat detail koneksi dan langganan peristiwa yang diperbarui di panel konfigurasi pemicu di bagian Detail Langganan Peristiwa.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah selanjutnya

• Pelajari semua tugas dan pemicu.
• Pelajari cara menguji dan memublikasikan integrasi.
• Pelajari penanganan error.
• Pelajari log eksekusi integrasi.