Cara Menghubungkan HubSpot ke Google Spreadsheet - Query Data CRM dengan SQL

Hubungkan HubSpot ke Google Sheets

Dapatkan data dari HubSpot ke dalam Lembar Kerja Google

Ambil data langsung dari akun HubSpot Anda ke Google Sheets dan perbarui kapan pun Anda mau. Tidak perlu unggah CSV, tidak perlu Apps Script, tidak perlu salin-tempel. Hanya butuh sekitar sepuluh menit untuk pertama kali, dan paket Gratis sudah mencakupnya.

Sekitar 10 menit Tidak perlu coding. Kredensial Anda akan tetap bersama Anda. Browser apa pun, perangkat apa pun

Inilah hasil akhirnya

Google Sheet yang menampilkan hasil langsung dari kueri SQL terhadap akun HubSpot Anda, dengan tombol yang menarik baris terbaru setiap kali data berubah. Seperti ini:

Penjualan Disimpan ke Drive

MengajukanEditMelihatMenyisipkanFormatDataPeralatanEkstensiMembantu

	A	B	C	D	E
1	customer_id	nama depan	nama belakang	negara	total
2	1042	Maria	Alvarez	Amerika Serikat	1,284.50
3	1043	Daniel	Okafor	Amerika Serikat	612.00
4	1047	Priya	Nair	Amerika Serikat	2,090.75
5	1051	Thomas	Berg	Amerika Serikat	338.20
6	1056	Lucía	Ferreira	Amerika Serikat	1,455.00
7	1060	Kenji	Sato	Amerika Serikat	874.10
8

+ pelanggan Lembar 1 Siaran langsung dari HubSpot

HubSpot menyimpan data Anda di balik API-nya. Memasukkannya ke Google Sheets biasanya berarti mengekspor CSV dari dasbor HubSpot setiap kali Anda membutuhkan angka terbaru. Query Streams melewati proses itu: program pembantu kecil bernama Agent menjalankan kueri di tempat data Anda berada, dan add-on Google Sheets meminta baris yang Anda inginkan. Hanya hasilnya yang dikirim, melalui tautan terenkripsi, dan Google Sheets dapat diakses di mana saja: browser apa pun di perangkat apa pun.

Yang Anda butuhkan

Akun Query Streams

Paket gratis sudah cukup untuk panduan ini. Daftar di sini. my.querystreams.com.

Agen pada komputer yang selalu menyala

Sebuah program kecil yang berjalan di latar belakang dan memanggil HubSpot ketika Google Sheets memintanya. Program ini hanya membutuhkan akses internet.

Informasi login HubSpot Anda

Anda akan masuk ke HubSpot sekali dan mengizinkan akses baca. Tidak ada kata sandi yang dimasukkan ke dalam Query Streams.

Hubungkan dalam lima langkah

1. Buat akun Anda

   Pergi ke my.querystreams.com dan mendaftar. Pilih Gratis Rencana ini adalah rencana nyata, bukan uji coba, dan mencakup menghubungkan akun HubSpot Anda dan menjalankan kueri dari Google Sheets.

2. Instal Agen pada komputer yang selalu menyala.

   Masuk, buka Unduh, dan instal Agen pada komputer atau server yang selalu aktif dan memiliki akses internet. Prosesnya hanya membutuhkan waktu satu menit dan akan berjalan dengan sendirinya setelah itu.

   Mengapa menggunakan program kecil alih-alih driver? Agent ini merupakan instalasi tunggal untuk Windows, Mac, atau Linux (sekitar 85 MB di Windows, sedikit lebih dari 100 MB di Mac dan Linux) yang berjalan diam-diam di latar belakang. Agent ini membuat satu koneksi keluar terenkripsi ke Query Streams, sama seperti yang dilakukan browser, sehingga Anda tidak perlu membuka port firewall dan mengatur VPN. Kunci Anda tetap berada di mesin tersebut, dan baris data dikirim ke mana pun Anda berada, melalui internet jika perlu. Satu-satunya hal yang Anda perlukan adalah add-on tersebut.

   Halaman Unduhan menampilkan Kunci Akses AndaTempelkan ke dalam Agent saat diminta, dan tunggu hingga badge terbaca. Terhubung ke Aliran KueriItulah satu-satunya hal yang Anda lakukan pada Agent itu sendiri.

   Panduan lengkap jika Anda menginginkannya: Windows, Mac, Linux.

3. Arahkan ke akun HubSpot Anda

   Kembali ke browser Anda, buka Agen Data (di bawah Data (di menu atas). Agen Anda terdaftar di sana. Klik Tambahkan konektor dan memilih HubSpotApakah Anda memerlukan kredensial HubSpot Anda terlebih dahulu? Buka panduan langkah demi langkah, lalu isi:

   Buat kredensial HubSpot Anda (sekitar 5 menit)

   Lanjutkan dengan membuka HubSpot di tab lain. Query Streams menyimpan apa yang Anda buat di sini sehingga Agen Anda dapat menggunakannya, dan hanya membaca dari HubSpot.

   Siapa yang bisa melakukan ini?

   Administrator super, atau pengguna dengan izin akses alat pengembang (kunci layanan). Aplikasi pribadi lama memerlukan administrator super.

   Direkomendasikan

   Kunci layanan dengan cakupan hanya baca (Pengembangan → Kunci → Kunci Layanan). HubSpot merekomendasikan kunci layanan untuk sinkronisasi data terjadwal ke alat dan gudang data BI, dan menghapus opsi untuk membuat aplikasi pribadi lama yang baru.

   Sebelum Anda mulai

   • Login HubSpot yang merupakan Super admin atau memiliki izin akses Developer tools. Kunci layanan hanya dapat diberikan cakupan yang sudah dimiliki oleh pengguna HubSpot Anda sendiri.
   • Ketahui akun HubSpot mana yang ingin Anda akses. Sebuah kunci hanya membaca akun tempat kunci tersebut dibuat, jadi buatlah di akun tersebut, bukan di akun uji coba atau sandbox.
   • Tentukan tabel HubSpot mana yang Anda inginkan. Kontak, Perusahaan, Kesepakatan, Pemilik, Pipeline, Tahapan Pipeline, dan Properti diaktifkan secara default; setiap tabel tambahan memerlukan cakupan baca tersendiri (lihat Izin).
   • Agen Query Streams terpasang dan online pada komputer yang selalu menyala, dan portal Query Streams terbuka di tab lain: Agen Data → Tambah konektor → HubSpot.

   Tangga

   1. Masuk ke HubSpot

      Buka HubSpot di tab baru dan masuk sebagai Super admin, atau sebagai pengguna dengan izin akses Alat Pengembang.

      Jika Anda memiliki lebih dari satu akun HubSpot, beralihlah ke akun yang datanya ingin Anda gunakan sebelum melanjutkan. Kunci tersebut hanya berlaku untuk akun tempat kunci tersebut dibuat.

   2. Pengembangan Terbuka

      Di navigasi utama sebelah kiri, di dekat bagian bawah, klik Pengembangan (ikon </>). Halaman Pengembangan akan terbuka dengan bilah sisi tersendiri: Ikhtisar, Proyek, Aplikasi Lama, Pemantauan, Kunci, dan lainnya.

      Tidak ada item Pengembangan? Pengguna HubSpot Anda bukan Super admin dan tidak memiliki akses ke alat Pengembang. Mintalah Super admin untuk membuat kunci, atau memberi Anda izin tersebut.

   3. Buka Kunci Layanan

      Di bilah sisi Pengembangan, klik Kunci untuk membukanya, lalu klik Kunci Layanan (terdapat lencana Beta). Halaman Kunci Layanan akan terbuka; jika Anda belum memilikinya, akan muncul tulisan Tidak Ada Kunci Layanan yang Dibuat.

      Jangan gunakan Kunci Akses Pribadi atau Kunci API Pengembang, yang terletak tepat di atas Kunci Layanan di menu yang sama. Itu adalah kunci alat pengembang dan tidak akan terhubung. Beberapa akun juga mengakses halaman ini dari Pengaturan (ikon roda gigi) → Integrasi → Kunci Layanan.

   4. Klik Buat kunci layanan

      Di pojok kanan atas halaman Kunci Layanan, klik Buat kunci layanan. Halaman Buat Kunci Layanan akan terbuka dengan kotak Nama dan bagian Cakupan.

   5. Sebutkan kuncinya

      Pada kolom Nama, ketik nama yang akan Anda kenali nanti, misalnya Query Streams read-only. HubSpot akan menampilkan nama ini di log-nya.

      Nama tersebut harus unik di akun HubSpot Anda.

   6. Buka pemilih cakupan

      Di samping Cakupan terpilih, klik + Tambah cakupan baru. Sebuah panel akan terbuka di sebelah kanan dengan kotak pencarian Temukan cakupan dan kotak centang untuk setiap cakupan.

   7. Centang keempat cakupan yang diperlukan

      Ketik setiap nama ke dalam Cari cakupan dan centang kotak centangnya: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read. Keempatnya mencakup setiap tabel yang disinkronkan Query Streams secara default.

      Centang hanya cakupan yang berakhiran .read. Query Streams hanya membaca dari HubSpot; ia tidak pernah membutuhkan cakupan .write.

   8. Centang kotak untuk tabel tambahan apa pun.

      Untuk setiap tabel tambahan yang Anda inginkan, centang cakupannya dari daftar Izin di bawah ini. Misalnya: crm.objects.tickets.read untuk Tiket; crm.objects.line_items.read untuk Item Baris, Pajak, Diskon, dan Biaya; crm.lists.read untuk Daftar. Lewati langkah ini jika tabel default sudah cukup.

      Anda dapat menambahkan cakupan (scope) nanti tanpa membuat kunci baru (buka kunci, lalu Edit).

   9. Klik Perbarui

      Klik Perbarui di panel sebelah kanan. Panel akan tertutup dan cakupan Anda akan tercantum di bawah Cakupan terpilih.

   10. Periksa daftar cakupan

       Baca daftar cakupan yang dipilih. Jika ada yang berakhiran .write, klik Hapus di sebelahnya. Perluas Ringkasan cakupan yang dipilih jika Anda menginginkan daftar dalam bahasa yang mudah dipahami tentang apa yang dapat dilihat oleh kunci tersebut.

   11. Buat kuncinya

       Klik Buat di pojok kanan atas, lalu konfirmasikan di kotak dialog yang muncul.

   12. Buka kunci baru Anda

       Buka Pengembangan → Kunci → Kunci Layanan dan klik nama kunci yang baru saja Anda buat. Halaman detailnya akan terbuka dengan kotak Kunci Layanan.

   13. Tampilkan dan salin kuncinya

       Di kotak Kunci Layanan, nilainya sebagian tersembunyi dan diawali dengan pat- (misalnya pat-na1-…). Klik Tampilkan di bawahnya, lalu klik Salin.

       Gunakan fitur Salin daripada memilih teks secara manual: karakter yang hilang, spasi di akhir teks, atau titik tersembunyi akan menyebabkan pengujian gagal. HubSpot tidak hanya menampilkan kunci sekali; Anda dapat kembali dan mengklik Tampilkan lagi. Perlakukan seperti kata sandi.

   14. Tempelkan ke Query Streams dan uji.

       Di portal Query Streams, buka Data Agents, klik Tambah konektor dan pilih HubSpot. Tempelkan kunci ke App Access Token, ketik nama Koneksi, lalu klik Uji koneksi. Hasilnya akan menampilkan Terhubung.

       Query Streams menyimpan kunci untuk Agen Anda dan hanya membaca data HubSpot Anda.

   15. Cocokkan tabel dengan cakupan Anda

       Pada langkah Sinkronisasi berikutnya, hanya sisakan tabel HubSpot yang cakupannya telah Anda centang pada langkah 7 dan 8, lalu selesaikan wizard.

       Tabel yang diaktifkan tanpa cakupannya akan gagal disinkronkan dengan kesalahan Terlarang. Tambahkan cakupan ke kunci (langkah 8) atau matikan tabel.

   Alternatif

   Gunakan token aplikasi pribadi lama.

   Akun Anda sudah memiliki aplikasi pribadi lama yang ingin Anda gunakan kembali. HubSpot menghapus opsi untuk membuat yang baru: akun yang dibuat pada atau setelah 28 September 2026 sudah tidak dapat membuatnya lagi, dan akun lama akan kehilangan opsi ini pada 26 Oktober 2026. Aplikasi pribadi yang sudah ada dan tokennya tetap berfungsi.

   Siapa yang bisa melakukan ini: Admin super

   1. Buka Aplikasi Lama

      Di HubSpot, klik Pengembangan di navigasi utama sebelah kiri, lalu Aplikasi Lama di bilah sisi Pengembangan.

      Navigasi HubSpot versi lama menyebut ini Pengaturan → Integrasi → Aplikasi Pribadi.

   2. Buka aplikasi pribadi Anda, atau mulai aplikasi baru.

      Jika aplikasi tersebut terdaftar, klik namanya dan lanjutkan ke langkah 6 (atau langkah 5 untuk menambahkan cakupan). Jika tidak, dan tombol tersebut masih ada, klik Buat aplikasi lama di kanan atas dan pilih Pribadi di kotak dialog.

      Tidak adanya tombol "Buat aplikasi lama" berarti pembuatan aplikasi sudah dinonaktifkan untuk akun Anda. Gunakan kunci layanan (langkah-langkah utama) sebagai gantinya.

   3. Beri nama aplikasi baru tersebut

      Pada tab Info Dasar, masukkan nama seperti Query Streams read-only. Logo dan deskripsi bersifat opsional.

   4. Tambahkan cakupan baca

      Klik tab Cakupan, klik Tambah cakupan baru, centang cakupan yang sama seperti pada langkah utama 7 dan 8, lalu klik Perbarui. Kemudian klik Buat aplikasi di kanan atas, baca pesan token akses di kotak dialog dan klik Lanjutkan pembuatan.

   5. Tambahkan cakupan ke aplikasi yang sudah ada (hanya jika diperlukan)

      Di halaman aplikasi, klik Edit aplikasi di kanan atas, buka tab Cakupan, tambahkan cakupan baca yang hilang, dan simpan. String token tidak berubah saat Anda mengubah cakupan.

   6. Tampilkan dan salin tokennya

      Di halaman aplikasi, klik tab Otorisasi. Di bawah Token akses, klik Tampilkan token, lalu klik Salin. Token dimulai dengan pat-. Tempelkan ke Token Akses Aplikasi seperti pada langkah utama 14.

      Jika pengguna HubSpot yang membuat aplikasi dihapus dari HubSpot, beberapa panggilan akan gagal dengan pesan kesalahan USER_DOES_NOT_HAVE_PERMISSIONS. Putar token (Putar di sebelahnya) dan tempel token yang baru, atau pindahkan ke kunci layanan.

   Gunakan token otentikasi statis aplikasi platform pengembang.

   Tim Anda telah membangun aplikasi HubSpot di platform pengembang baru menggunakan HubSpot CLI, yang dikonfigurasi dengan otentikasi statis dan distribusi privat. Membangun aplikasi membutuhkan CLI; jika Anda tidak memilikinya, gunakan kunci layanan.

   Siapa yang bisa melakukan ini: Administrator super, atau pengguna dengan hak akses pengembang, untuk melihat token; Administrator super atau izin akses HubSpot Marketplace untuk menginstal aplikasi.

   1. Buka proyek

      Di HubSpot, klik Pengembangan, lalu Proyek di bilah sisi, kemudian nama proyek yang berisi aplikasi Anda.

   2. Buka aplikasinya

      Pada tab Gambaran Umum proyek, di bawah Komponen Proyek, klik nama aplikasi.

   3. Buka tab Distribusi

      Klik tab Distribusi.

   4. Instal aplikasinya jika belum terinstal.

      Di bawah Kelola distribusi, akun HubSpot Anda saat ini terdaftar. Klik Instal sekarang, periksa apakah akses yang diminta sesuai dengan cakupan baca yang telah Anda konfigurasi, lalu klik Hubungkan aplikasi.

      Aplikasi token statis hanya dapat diinstal di satu akun HubSpot standar dalam satu waktu.

   5. Tampilkan dan salin tokennya

      Setelah terinstal, tab Distribusi akan menampilkan token akses. Klik Tampilkan untuk melihatnya, salin, dan tempelkan ke Token Akses Aplikasi seperti pada langkah utama 14.

      Jika Anda mengubah cakupan aplikasi di kemudian hari, instal ulang aplikasi tersebut menggunakan URL Instal Ulang di tab Distribusi, atau cakupan baru tidak akan diterapkan.

   Izin untuk memberikan

   Sumber	Akses	Digunakan untuk
   crm.objek.kontak.baca	Membaca	Diperlukan. hubspot.contacts, ditambah tabel aktivitas hubspot.calls, hubspot.emails, hubspot.meetings, hubspot.notes, hubspot.tasks dan hubspot.communications (API aktivitas HubSpot menggunakan cakupan ini), dan bidang kontak di hubspot.properties dan hubspot.associations.
   crm.objek.perusahaan.baca	Membaca	Diperlukan. hubspot.companies, dan kolom perusahaan di hubspot.properties dan hubspot.associations.
   crm.objek.kesepakatan.baca	Membaca	Diperlukan. hubspot.deals, alur transaksi di hubspot.pipelines dan hubspot.pipeline_stages, serta kolom transaksi di hubspot.properties dan hubspot.associations.
   crm.objek.pemilik.baca	Membaca	Wajib diisi. hubspot.owners, yaitu pengguna HubSpot yang memiliki catatan, sehingga kesepakatan dan kontak dapat dihubungkan ke nama perwakilan.
   crm.objek.tiket.baca	Membaca	Hanya jika Anda menyinkronkan Tiket: hubspot.tickets dan pipeline tiket di hubspot.pipelines dan hubspot.pipeline_stages. Aplikasi lama mungkin menampilkan cakupan tiket lama, yang juga memungkinkan perubahan.
   crm.objek.produk.baca	Membaca	Hanya jika Anda menyinkronkan Produk: hubspot.products. Cari produk di pemilih; API produk HubSpot menerima cakupan ini, meskipun halaman referensi cakupan HubSpot belum mencantumkannya.
   crm.objek.item_baris.baca	Membaca	Hanya jika Anda menyinkronkan Item Baris, Pajak, Diskon, atau Biaya: hubspot.line_items, hubspot.taxes, hubspot.discounts, hubspot.fees.
   crm.objek.kutipan.baca	Membaca	Hanya jika Anda menyinkronkan Kutipan: hubspot.quotes.
   crm.objek.faktur.baca	Membaca	Hanya jika Anda menyinkronkan Faktur: hubspot.invoices.
   crm.objek.langganan.baca	Membaca	Hanya jika Anda menyinkronkan Langganan: hubspot.subscriptions (langganan HubSpot Commerce).
   crm.objek.perdaganganpembayaran.baca	Membaca	Hanya jika Anda menyinkronkan Pembayaran: hubspot.payments (Pembayaran HubSpot Commerce).
   crm.objek.acara_pemasaran.baca	Membaca	Hanya jika Anda menyinkronkan Acara Pemasaran: hubspot.marketing_events.
   formulir	Membaca dan menulis (HubSpot tidak memiliki cakupan formulir hanya baca)	Hanya jika Anda menyinkronkan Formulir atau Pengiriman Formulir: hubspot.forms dan hubspot.form_submissions. Query Streams hanya membacanya.
   crm.objek.pengajuan_umpan_balik.baca	Membaca	Hanya jika Anda menyinkronkan Feedback: hubspot.feedback_submissions. Hanya untuk Service Hub Professional atau Enterprise. Referensi cakupan HubSpot menuliskannya sebagai crm.objects.feedback_submission.read, jadi carilah feedback di picker.
   crm.lists.read	Membaca	Hanya jika Anda menyinkronkan Daftar: hubspot.lists.
   otomatisasi	Membaca dan menulis (Hub HubSpot tidak memiliki cakupan alur kerja hanya baca)	Hanya jika Anda menyinkronkan Alur Kerja: hubspot.workflows. Hanya untuk akun Profesional atau Enterprise. Query Streams hanya membaca definisi alur kerja.
   crm.schemas.custom.read	Membaca	Hanya jika Anda menyinkronkan Skema Kustom: hubspot.schemas (definisi objek kustom). Hanya untuk akun Enterprise.

   Tempelkan ke Aliran Kueri

   Token Akses Aplikasi

   Kunci layanan yang Anda salin di langkah 13 (diawali dengan pat-), atau token aplikasi pribadi lama, atau token otentikasi statis aplikasi platform pengembang.

   Masalah umum

   Pengujian koneksi gagal dengan token akses tidak valid atau kedaluwarsa, tepat setelah Anda menempelkan kunci baru.

   Mengapa: Nilai tersebut bukanlah kunci aplikasi atau layanan. Kesalahan umum yang terjadi adalah Kunci Akses Pribadi atau Kunci API Pengembang, yang terletak di sebelah Kunci Layanan di bawah Pengembangan → Kunci dan digunakan untuk alat pengembang HubSpot.

   Memperbaiki: Buka Pengembangan → Kunci → Kunci Layanan, buka kunci Anda, klik Tampilkan, lalu Salin, dan tempelkan ke Token Akses Aplikasi. Uji koneksi lagi; akan terbaca Terhubung.

   Wizard tersebut mengatakan "Bukan token aplikasi HubSpot yang valid" bahkan sebelum melakukan pengujian.

   Mengapa: Hanya sebagian dari kunci yang disalin: teksnya tidak diawali dengan "pat-" dan sangat pendek atau mengandung spasi.

   Memperbaiki: Kembali ke HubSpot, klik Tampilkan, lalu gunakan Salin tautan (jangan pilih teks secara manual) dan tempel lagi.

   Anda tidak dapat melihat Pengembangan di navigasi sebelah kiri HubSpot, atau Kunci Layanan hilang di bawah Kunci.

   Mengapa: Pengguna HubSpot Anda bukan Super admin dan tidak memiliki izin akses ke alat pengembang.

   Memperbaiki: Mintalah administrator super di perusahaan Anda untuk membuat kunci (langkah 2 hingga 13) dan menempelkannya ke dalam wizard, atau untuk memberi Anda akses ke alat pengembang.

   Pengujian koneksi menunjukkan Terhubung, tetapi satu tabel gagal disinkronkan dengan kesalahan Terlarang atau tetap kosong.

   Mengapa: Kuncinya adalah kurangnya cakupan baca untuk tabel tersebut, atau paket HubSpot Anda tidak menyertakan fitur tersebut (Workflows membutuhkan Professional atau Enterprise; Custom Schemas membutuhkan Enterprise; Feedback membutuhkan Service Hub Professional atau Enterprise).

   Memperbaiki: Buka kunci (Pengembangan → Kunci → Kunci Layanan → nama kunci), klik Edit, tambahkan cakupan dari daftar Izin dan simpan, lalu sinkronkan lagi. Jika paket Anda tidak menyertakan fitur tersebut, matikan tabel tersebut di pengaturan Sinkronisasi koneksi.

   Sinkronisasi yang sebelumnya berfungsi mulai gagal dengan pesan "Token akses tidak valid atau kedaluwarsa".

   Mengapa: Seseorang telah merotasi atau menghapus kunci tersebut. Opsi "Rotasi dan kedaluwarsa sekarang" akan langsung menghentikan kunci lama; opsi "Rotasi dan kedaluwarsa nanti" akan menghentikannya setelah 7 hari.

   Memperbaiki: Salin kunci saat ini dari Pengembangan → Kunci → Kunci Layanan → nama kunci → Tampilkan → Salin. Di Agen Data, edit koneksi HubSpot, tempelkan ke Token Akses Aplikasi, dan jalankan Uji koneksi.

   Dengan token aplikasi pribadi lama, beberapa tabel mengalami kegagalan dengan pesan USER_DOES_NOT_HAVE_PERMISSIONS.

   Mengapa: Pengguna HubSpot yang membuat aplikasi pribadi tersebut telah dihapus dari akun.

   Memperbaiki: Putar token aplikasi (Pengembangan → Aplikasi Lama → aplikasi → Putar) dan tempel token baru ke dalam koneksi, atau buat kunci layanan sebagai gantinya.

   Anda tidak dapat menemukan opsi Buat aplikasi lama, atau dokumentasi HubSpot menyebut aplikasi pribadi sebagai aplikasi lama.

   Mengapa: HubSpot akan menghentikan pembuatan aplikasi pribadi lama yang baru (sudah dinonaktifkan untuk akun yang dibuat pada atau setelah 28 September 2026; dinonaktifkan untuk akun lama mulai 26 Oktober 2026). Aplikasi pribadi yang sudah ada tetap berfungsi.

   Memperbaiki: Buat kunci layanan (langkah-langkah utama). Token aplikasi pribadi yang sudah ada dapat tetap digunakan.

   Data di Query Streams tidak sesuai dengan yang Anda lihat di HubSpot.

   Mengapa: Kunci tersebut dibuat di akun HubSpot yang berbeda (misalnya akun uji atau sandbox).

   Memperbaiki: Beralihlah ke akun HubSpot yang benar, buat kunci di sana, lalu tempelkan ke dalam koneksi.

   Batasan untuk mengetahui

   • Batasan HubSpot untuk kunci layanan dan aplikasi pribadi: 100 permintaan per 10 detik per kunci pada paket Gratis dan Starter, 190 pada paket Profesional dan Enterprise, 250 dengan add-on Peningkatan Batas API. Agent menyesuaikan diri dengan batasan terendah ini, sehingga sinkronisasi penuh pertama dari CRM besar dapat memakan waktu cukup lama.
   • Batas harian per akun HubSpot: 250.000 permintaan untuk paket Gratis dan Starter, 625.000 untuk paket Profesional, dan 1.000.000 untuk paket Enterprise. Batas ini dibagi oleh setiap kunci aplikasi dan layanan pribadi di akun tersebut, sehingga integrasi lain menggunakan anggaran yang sama.
   • Fitur pencarian CRM HubSpot, yang digunakan Agen untuk mengambil hanya data yang berubah, memungkinkan 5 permintaan per detik per akun dan maksimal 10.000 hasil per kueri.
   • Beberapa tabel bergantung pada paket HubSpot Anda: Alur Kerja (Profesional atau Enterprise), Skema Kustom (Enterprise), Umpan Balik (Service Hub Profesional atau Enterprise).
   • Kunci layanan sedang dalam versi beta publik (sejak 10 Februari 2026), jadi HubSpot mungkin mengubah detailnya. HubSpot merekomendasikan untuk mengganti kunci setiap enam bulan.
   • Aplikasi pribadi lama yang baru tidak dapat dibuat di akun yang dibuat pada atau setelah 28 September 2026, maupun di akun lama sejak 26 Oktober 2026. Aplikasi dan token yang sudah ada tetap berfungsi.

   Langkah-langkah diverifikasi pada 8 Oktober 2026. Sumber: developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/changelog/service-keys, developers.hubspot.com/blog/hubspot-service-keys-the-righ…, developers.hubspot.com/changelog/legacy-private-app-create…, developers.hubspot.com/docs/apps/legacy-apps/private-apps…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/getting-started/developer-ove…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/developer-tooling/platform/us…, developers.hubspot.com/docs/api-reference/latest/crm/sear…, knowledge.hubspot.com/user-management/hubspot-user-permis…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/pipe…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/automati…, developers.hubspot.com/docs/api-reference/legacy/marketing…, developers.hubspot.com/docs/api-reference/legacy/account/…, docs.n8n.io/integrations/builtin/credentials/hubspot.

   Nama koneksi

   Nama apa pun yang akan Anda kenali nanti, seperti basis data Penjualan.

   Token Akses Aplikasi

   Token Aplikasi Pribadi HubSpot (diawali dengan pat-), dapat ditemukan di Pengaturan, Integrasi, Aplikasi Pribadi, aplikasi Anda, tab Otorisasi.

   Klik Uji koneksiSaat terbaca Terhubung, klik SimpanKoneksi akan sampai ke Agen Anda dalam beberapa detik.

   Agen Data Terbuka

   Tes gagal? Biasanya karena izin yang hilang, atau kredensial dari akun HubSpot yang salah. Panduan di atas mencantumkan hal-hal berikut. masalah umum dan solusi perbaikannya.

4. See your data in Query Builder Opsional

   You can look at your HubSpot account before Google Sheets is involved at all. Open Pembuat Kueri in the portal and pick the connection you just made. The Skema tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Jalankan and the rows appear under Hasil. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Menambahkan Aliran Kueri ke Google Sheets

   Buka Google Sheet mana pun, lalu buka Ekstensi → Pengaya → Dapatkan pengaya, cari Aliran Kuerilalu klik MemasangAtau instal langsung dari Aliran Kueri di Google Workspace MarketplaceGoogle akan meminta Anda untuk mengizinkan add-on tersebut; itu normal.

   Setelah itu, ikon Query Streams akan muncul di setiap Google Sheet yang Anda buka: ikon di panel samping sebelah kanan, juga tercantum di bawah EkstensiTidak ada proses masuk terpisah. Sistem mengenali akun Google yang sudah Anda gunakan, jadi email yang digunakan harus sama dengan email yang terdaftar di akun Query Streams Anda.

6. Tarik meja pertama Anda

   Klik ikon Aliran Kueri di panel samping di sebelah kanan lembar (atau temukan di bawah Ekstensi). Memilih Pengalir Kueri lalu pilih koneksi yang baru saja Anda buat.

   Ketik kueri yang ingin Anda jalankan. Kueri ini mengambil beberapa kolom dari sebuah hubspot.deals meja:

   Contoh · SQL

   SELECT dealname, dealstage, amount, closedate FROM hubspot.deals ORDER BY closedate DESC LIMIT 100;

   Di bawah Lembar Tujuan pilih tab tempat baris-baris tersebut akan ditempatkan, lalu klik Jalankan QueryBaris-baris data akan muncul di tab tersebut dalam satu atau dua detik. Klik Jalankan Kueri lagi setiap kali data berubah dan tab akan diperbarui secara otomatis.

   Tidak tahu SQL? Build it in Pembuat Kueri first and paste it here, or pick it from Saved Queries if you saved it.

Langkah selanjutnya yang bagus

• Simpan kueri di portal sehingga Anda dapat menjalankannya lagi dengan sekali klik, dari Google Sheets atau Excel.
• Tambahkan filter misalnya rentang tanggal, sehingga kueri yang sama dapat menjawab "bulan ini" tanpa perlu diedit.
• Bagikan hasilnya bersama seorang kolega. Mereka melihat baris-barisnya, bukan kredensial Anda.

Pertanyaan yang diajukan orang

Panduan terkait

• HubSpot ke Microsoft Excel
• Stripe ke Google Sheets
• Shopify ke Google Sheets
• Google Analytics 4 ke Google Sheets
• Kueri Daya untuk Google Spreadsheet
• Semua panduan