HubSpot credentials#

คุณสามารถใช้ credentials เหล่านี้เพื่อยืนยันตัวตนกับ node ต่อไปนี้ได้:

Supported authentication methods#

App token: ใช้กับ node HubSpot
Developer API key: ใช้กับ node HubSpot Trigger
OAuth2: ใช้กับ node HubSpot

API key deprecated

HubSpot ได้ยกเลิกวิธีการยืนยันตัวตนด้วย API Key แบบปกติแล้ว ตัวเลือกนี้ยังคงปรากฏใน n8n แต่คุณควรใช้วิธีการยืนยันตัวตนที่ระบุไว้ข้างต้นแทน หากคุณมีการรวมระบบที่มีอยู่ซึ่งใช้วิธี API key นี้ โปรดดูคู่มือ Migrate an API key integration to a private app ของ HubSpot และตั้งค่า app token

ดูข้อมูลเพิ่มเติมเกี่ยวกับบริการนี้ได้ที่ HubSpot's API documentation node HubSpot Trigger ใช้ Webhooks API; ดูข้อมูลเพิ่มเติมเกี่ยวกับบริการนั้นได้ที่ HubSpot's Webhooks API documentation

Using App token#

ในการตั้งค่า credential นี้ คุณจะต้องมีบัญชี HubSpot หรือบัญชีนักพัฒนา HubSpot developer และ:

App Token

ในการสร้าง app token ให้สร้าง private app ใน HubSpot:

ในบัญชี HubSpot ของคุณ เลือก settings icon ในแถบนำทางหลัก
ในเมนูแถบด้านข้างซ้าย ไปที่ Integrations > Private Apps
เลือก Create private app
บนแท็บ Basic Info ป้อน Name ของแอปของคุณ
วางเมาส์เหนือ placeholder logo และเลือกไอคอนอัปโหลดเพื่ออัปโหลดภาพสี่เหลี่ยมจัตุรัสที่จะใช้เป็นโลโก้สำหรับแอปของคุณ
ป้อน Description สำหรับแอปของคุณ
เปิดแท็บ Scopes และเพิ่ม scopes ที่เหมาะสม ดูรายการ scopes ทั้งหมดที่คุณควรเพิ่มได้ที่ Required scopes for HubSpot node
เลือก Create app เพื่อสิ้นสุดกระบวนการ
ใน modal ตรวจสอบข้อมูลเกี่ยวกับ access token ของแอปของคุณ จากนั้นเลือก Continue creating
เมื่อแอปของคุณสร้างเสร็จแล้ว ให้เปิด Access token card และเลือก Show token เพื่อแสดง token
คัดลอก token นี้และป้อนลงใน n8n credential ของคุณ

ดูข้อมูลเพิ่มเติมได้ที่ HubSpot Private Apps documentation

Using Developer API key#

ในการตั้งค่า credential นี้ คุณจะต้องมีบัญชีนักพัฒนา HubSpot developer และ:

Client ID: สร้างขึ้นเมื่อคุณสร้าง public app
Client Secret: สร้างขึ้นเมื่อคุณสร้าง public app
Developer API Key: สร้างจาก dashboard Developer Apps ของคุณ
App ID: สร้างขึ้นเมื่อคุณสร้าง public app

วิธีสร้าง public app และตั้งค่า credential:

เข้าสู่ระบบบัญชีนักพัฒนาแอป HubSpot app developer account ของคุณ
เลือก Apps จากแถบนำทางหลัก
เลือก Get HubSpot API key คุณอาจต้องเลือกตัวเลือก Show key
คัดลอก key และป้อนลงใน n8n เป็น Developer API Key
ยังคงอยู่ในหน้า HubSpot Apps เลือก Create app
บนแท็บ App Info เพิ่ม App name, Description, Logo และข้อมูลติดต่อฝ่ายสนับสนุนที่คุณต้องการให้ ใครก็ตามที่พบแอปจะเห็นข้อมูลเหล่านี้
เปิดแท็บ Auth
คัดลอก App ID และป้อนลงใน n8n
คัดลอก Client ID และป้อนลงใน n8n
คัดลอก Client Secret และป้อนลงใน n8n
ในส่วน Scopes เลือก Add new scope
เพิ่ม scopes ทั้งหมดที่ระบุใน Required scopes for HubSpot Trigger node ลงในแอปของคุณ
เลือก Update
คัดลอก OAuth Redirect URL ของ n8n และป้อนเป็น Redirect URL ในแอป HubSpot ของคุณ
เลือก Create app เพื่อสิ้นสุดการสร้างแอป HubSpot

ดูคำแนะนำโดยละเอียดเพิ่มเติมได้ที่ HubSpot Public Apps documentation

Required scopes for HubSpot Trigger node#

หากคุณกำลังสร้างแอปเพื่อใช้กับ node HubSpot Trigger n8n แนะนำให้เริ่มต้นด้วย scopes เหล่านี้:

Element	Object	Permission	Scope name
n/a	n/a	n/a	`oauth`
CRM	Companies	Read	`crm.objects.companies.read`
CRM	Companies schemas	Read	`crm.schemas.companies.read`
CRM	Contacts	Read	`crm.objects.contacts.read`
CRM	Contacts schemas	Read	`crm.schemas.contacts.read`
CRM	Deals	Read	`crm.objects.deals.read`
CRM	Deals schemas	Read	`crm.schemas.deals.read`

HubSpot old accounts

บัญชี HubSpot บางบัญชีไม่สามารถเข้าถึง scopes ทั้งหมดได้ HubSpot กำลังทยอยย้ายบัญชี หากคุณไม่พบ scopes ทั้งหมดในบัญชีนักพัฒนา HubSpot ปัจจุบันของคุณ ลองสร้างบัญชีนักพัฒนาใหม่

Using OAuth2#

หมายเหตุสำหรับผู้ใช้ n8n Cloud

ผู้ใช้ Cloud ไม่จำเป็นต้องให้รายละเอียดการเชื่อมต่อ เลือก Connect my account เพื่อเชื่อมต่อผ่านเบราว์เซอร์ของคุณ

หากคุณ self-hosting n8n คุณจะต้องตั้งค่า OAuth2 ตั้งแต่ต้นโดยสร้าง public app ใหม่:

เข้าสู่ระบบบัญชีนักพัฒนาแอป HubSpot app developer account ของคุณ
เลือก Apps จากแถบนำทางหลัก
เลือก Create app
บนแท็บ App Info เพิ่ม App name, Description, Logo และข้อมูลติดต่อฝ่ายสนับสนุนที่คุณต้องการให้ ใครก็ตามที่พบแอปจะเห็นข้อมูลเหล่านี้
เปิดแท็บ Auth
คัดลอก App ID และป้อนลงใน n8n
คัดลอก Client ID และป้อนลงใน n8n
คัดลอก Client Secret และป้อนลงใน n8n
ในส่วน Scopes เลือก Add new scope
เพิ่ม scopes ทั้งหมดที่ระบุใน Required scopes for HubSpot node ลงในแอปของคุณ
เลือก Update
คัดลอก OAuth Redirect URL ของ n8n และป้อนเป็น Redirect URL ในแอป HubSpot ของคุณ
เลือก Create app เพื่อสิ้นสุดการสร้างแอป HubSpot

ดูคำแนะนำโดยละเอียดเพิ่มเติมได้ที่ HubSpot Public Apps documentation หากคุณต้องการรายละเอียดเพิ่มเติมเกี่ยวกับสิ่งที่เกิดขึ้นใน OAuth web flow โปรดดู HubSpot Working with OAuth documentation

Required scopes for HubSpot node#

หากคุณกำลังสร้างแอปเพื่อใช้กับ node HubSpot n8n แนะนำให้เริ่มต้นด้วย scopes เหล่านี้:

Element	Object	Permission	Scope name(s)
n/a	n/a	n/a	`oauth`
n/a	n/a	n/a	`forms`
n/a	n/a	n/a	`tickets`
CRM	Companies	Read Write	`crm.objects.companies.read` `crm.objects.companies.write`
CRM	Companies schemas	Read	`crm.schemas.companies.read`
CRM	Contacts schemas	Read	`crm.schemas.contacts.read`
CRM	Contacts	Read Write	`crm.objects.contacts.read` `crm.objects.contacts.write`
CRM	Deals	Read Write	`crm.objects.deals.read` `crm.objects.deals.write`
CRM	Deals schemas	Read	`crm.schemas.deals.read`
CRM	Owners	Read	`crm.objects.owners.read`
CRM	Lists	Write	`crm.lists.write`