Lihat konektor yang didukung untuk Application Integration.

Pemicu HubSpot

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

Sebelum memulai

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

Admin Konektor (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:

Invoker Integrasi Aplikasi (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 daftar lengkap jenis peristiwa, lihat Langganan webhook.

Menambahkan pemicu HubSpot

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

Di konsol Google Cloud, buka halaman Application Integration.
Buka Application Integration
Di menu navigasi, klik Integrasi
Halaman Integrations List akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.
Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.
Jika Anda membuat integrasi baru:
1. Masukkan nama dan deskripsi di panel Create Integration.
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 wilayah baru untuk informasi selengkapnya.
3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary 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.
Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
Klik dan tempatkan elemen HubSpot trigger di editor integrasi.

Untuk mengonfigurasi pemicu HubSpot, Anda dapat menggunakan koneksi HubSpot yang sudah 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 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:

Klik elemen HubSpot trigger di integration editor untuk membuka panel konfigurasi pemicu.
Klik Konfigurasi pemicu.
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.
  Application Integration hanya menampilkan koneksi HubSpot yang aktif dan memiliki langganan acara aktif.
3. Jenis peristiwa:Pilih jenis peristiwa yang ingin Anda gunakan untuk memicu integrasi. Untuk daftar jenis peristiwa yang didukung, lihat jenis peristiwa yang didukung.
4. Akun Layanan: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu HubSpot.
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:

Klik elemen HubSpot trigger di integration editor untuk membuka panel konfigurasi pemicu.
Klik Konfigurasi pemicu.
Lewati kolom Region.
Klik Connection, lalu pilih opsi Create Connection di menu drop-down.
Selesaikan langkah-langkah berikut di panel Create Connection:
1. Pada langkah Lokasi, pilih lokasi untuk koneksi HubSpot baru:
  1. Region: Pilih wilayah dari menu drop-down.
  2. Klik Next.
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 kecil.
    - Nama koneksi harus dimulai dengan huruf dan diakhiri dengan huruf atau angka.
    - Nama koneksi tidak boleh lebih dari 63 karakter.
  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 dipilih, opsi berikut akan ditampilkan:
    - Enable event subscription with entity and actions: Pilih opsi ini untuk menggunakan koneksi untuk operasi konektor dan langganan peristiwa (entity dan tindakan).
    - Aktifkan hanya langganan acara: Pilih opsi ini untuk menggunakan koneksi hanya untuk langganan acara.
    Untuk kedua pilihan ini, Anda akan diminta untuk mengonfigurasi detail peristiwa pada langkah berikutnya.
  7. Skema: Menentukan 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 entity Contacts yang ingin Anda pilih dari operasi entity 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. Properti Transaksi: Masukkan nama kolom yang dipisahkan koma dari entitas Deals yang ingin Anda pilih dari operasi entitas List. Misalnya, fieldA, fieldB, fieldC
  12. Use proxy: Centang kotak ini guna mengonfigurasi server proxy untuk koneksi.
  13. Proxy Auth Scheme: Jenis autentikasi yang 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. Jenis SSL Proxy: Jenis SSL yang akan digunakan saat terhubung ke proxy ProxyServer.
  17. Secara opsional, konfigurasikan Setelan node koneksi:
    - Jumlah minimum node: Masukkan jumlah minimum node koneksi.
    - Jumlah maksimum node: Masukkan jumlah maksimum node koneksi.
    {i>Node<i} adalah unit (atau replika) koneksi yang memproses transaksi. Lebih banyak node diperlukan untuk memproses lebih banyak transaksi untuk sebuah koneksi dan sebaliknya, lebih sedikit node diperlukan untuk memproses transaksi yang lebih sedikit. Untuk memahami pengaruh node terhadap harga konektor Anda, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum akan ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.
  18. Secara opsional, klik + Add label untuk menambahkan label ke Connection dalam bentuk key-value pair.
  19. Klik Next.
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. Dengan lampiran layanan, Anda dapat 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 Next.
4. Di bagian Authentication, masukkan detail autentikasi.
  1. Pilih Jenis autentikasi, lalu masukkan detail yang relevan.
    Jenis autentikasi berikut didukung oleh koneksi HubSpot:
    - Token Akses Aplikasi Pribadi: Pilih Secret Manager yang berisi token akses aplikasi pribadi.
      Dengan aplikasi pribadi, Anda dapat menggunakan API HubSpot untuk mengakses data tertentu dari akun HubSpot. Anda dapat mengizinkan hal 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 untuk 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 Next.
5. Jika Anda telah mengaktifkan langganan acara, bagian Detail Langganan Acara 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 rahasia Secret Manager dari rahasia klien aplikasi pribadi Anda, dan versi rahasia yang sesuai dari menu drop-down Secret Version.
  2. Pilih Aktifkan konektivitas pribadi untuk konektivitas yang 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 acara.
  3. Masukkan konfigurasi yang dihentikan pengirimannya. Jika Anda mengonfigurasi huruf mati, koneksi akan menulis peristiwa yang belum diproses ke topik Pub/Sub yang ditentukan. Masukkan detail berikut:
    1. ID project yang dihentikan pengirimannya: ID project Google Cloud tempat Anda mengonfigurasi topik Pub/Sub yang dihentikan pengirimannya.
    2. Topik yang dihentikan pengirimannya: Topik Pub/Sub tempat Anda ingin menulis detail peristiwa yang belum diproses.
  4. Klik Next.
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 Anda. Oleh karena itu, setelah pembuatan koneksi berhasil, lakukan langkah-langkah tambahan berikut:

Buka halaman detail koneksi dari koneksi yang baru dibuat, lalu salin URL webhook untuk langganan acara. URL webhook diperlukan saat Anda membuat langganan webhook di langkah berikutnya.
Gambar berikut menampilkan kolom Events pemroses endpoint di halaman detail koneksi HubSpot:
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 di bagian Detail Langganan Acara.

Pemicu HubSpot menunjukkan status langganan peristiwa menggunakan status berikut:

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

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

Gambar berikut menunjukkan contoh tata letak panel konfigurasi pemicu HubSpot:

gambar yang menampilkan panel konfigurasi pemicu HubSpot

Variabel output pemicu

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

Lihat langganan acara

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

Buka halaman Integration Connectors > Connections.
Buka halaman Connections
Klik koneksi yang ingin Anda lihat langganannya.
Klik tab Langganan acara.
Ini akan menampilkan semua langganan peristiwa untuk koneksi tersebut.

Edit pemicu HubSpot

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

Untuk mengedit pemicu HubSpot, ikuti langkah-langkah berikut:

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

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