Lihat konektor yang didukung untuk Application Integration.

Pemicu HubSpot

Pratinjau — HubSpot trigger

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari 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: Integration Connectors adalah komponen yang dapat ditagih dari Google Cloud. 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:

• Pemanggil Integrasi Aplikasi (roles/integrations.integrationInvoker)

Untuk mengetahui 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 mana yang akan diterima aplikasi Anda. Jenis langganan berikut didukung:

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

Menambahkan pemicu HubSpot

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

1. Di konsol Google Cloud , buka halaman Application Integration.

   Buka Integrasi Aplikasi

2. Di menu navigasi, klik Integrasi.

   Halaman Integrations List akan muncul dan 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: Dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, Klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk mengetahui 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 Buat.

   Integrasi yang baru dibuat akan terbuka 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 dan tersedia di Integration Connectors, 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 Integration Connectors. 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 acara: Pilih jenis acara yang ingin Anda gunakan untuk memicu integrasi. Untuk mengetahui daftar jenis peristiwa yang didukung, lihat jenis peristiwa yang didukung.
   4. Akun Layanan: 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 dan pilih opsi Create Connection dari menu drop-down.
5. Selesaikan langkah-langkah berikut di panel Buat Koneksi:
   1. Pada langkah Location, pilih lokasi untuk koneksi HubSpot baru:
      1. Region: Pilih region dari menu drop-down.
      2. Klik Berikutnya.
   2. Di bagian Connection Details, selesaikan langkah-langkah berikut:
      1. Konektor: Pilih HubSpot dari daftar drop-down Konektor yang tersedia.
      2. Versi konektor: Pilih versi Konektor dari daftar drop-down versi yang tersedia.
      3. Di kolom Connection Name, masukkan nama untuk instance Koneksi.

         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 Deskripsi untuk instance koneksi.
      5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
      6. Untuk menggunakan koneksi untuk langganan acara, pilih Aktifkan langganan acara. Jika Anda memilih opsi ini, opsi berikut akan ditampilkan:
         • Aktifkan langganan peristiwa dengan entitas dan tindakan: Pilih opsi ini untuk menggunakan koneksi untuk operasi langganan peristiwa dan konektor (entitas 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. Skema: 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. Properti Kontak: Masukkan nama kolom yang dipisahkan koma dari entitas Contacts yang ingin Anda pilih dari operasi entitas List. Misalnya, fieldA, fieldB, fieldC
      10. Properti Perusahaan: Masukkan nama kolom yang dipisahkan koma dari entitas Companies yang ingin Anda pilih dari operasi entitas List. Misalnya, fieldA, fieldB, fieldC
      11. Properti Penawaran: 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. Skema Autentikasi Proxy: Jenis autentikasi yang akan digunakan untuk mengautentikasi ke proxy ProxyServer.
      14. Pengguna Proxy: Nama pengguna yang akan digunakan untuk mengautentikasi ke proxy ProxyServer.
      15. Sandi Proxy: Sandi yang akan digunakan untuk mengautentikasi ke proxy ProxyServer.
      16. Proxy SSL Type: Jenis SSL yang akan digunakan saat terhubung ke proxy ProxyServer.
      17. Jika perlu, konfigurasikan Setelan node koneksi:
          • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
          • Jumlah node maksimum: Masukkan jumlah maksimum node koneksi.

          Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk suatu koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. 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 Anda adalah pelanggan Bayar sesuai penggunaan.
      18. Atau, klik + Tambahkan label untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
      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 mengetahui informasi tentang cara mengonfigurasi Private Service Connect, lihat Memublikasikan layanan terkelola.

         Berdasarkan pilihan jenis tujuan Anda, 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 mengizinkan 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 Anda, 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 mengetahui 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 acara, berikan detail autentikasi yang akan digunakan untuk memvalidasi payload token HubSpot:
      1. Rahasia Klien: (Opsional) Pilih secret Secret Manager dari rahasia klien aplikasi pribadi Anda, dan versi secret yang sesuai dari drop-down Versi Secret.

      Untuk mengetahui informasi selengkapnya, lihat Aplikasi pribadi.

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

Membuat dan mengedit langganan webhook

Untuk menyelesaikan konfigurasi langganan peristiwa, Anda harus mendaftarkan URL webhook dengan aplikasi HubSpot Anda. 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 acara. URL webhook diperlukan saat Anda membuat langganan webhook pada 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 acara di panel konfigurasi pemicu pada bagian Detail Langganan Acara.

Pemicu HubSpot menunjukkan status langganan peristiwa menggunakan status berikut:

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

Selain status langganan acara, bagian Event Subscription details juga menampilkan detail lain seperti region koneksi, nama koneksi, nama langganan acara, dan lainnya.

Gambar berikut menunjukkan contoh tata letak panel konfigurasi pemicu HubSpot:

Variabel output pemicu

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

Melihat langganan acara

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

1. Buka halaman Integration Connectors > Connections.

   Buka halaman Koneksi

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

   Tindakan ini akan menampilkan semua langganan peristiwa untuk koneksi.

Edit 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 acara yang sebelumnya dikonfigurasi dan dilampirkan ke pemicu, atau menghapusnya. Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan yang 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 Selesai.

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 berikutnya

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