- ฐานความรู้
- บัญชีและการตั้งค่า
- การผสานการทำงาน
- เชื่อมต่อ HubSpot และ AWS S3
เบต้าเชื่อมต่อ HubSpot และ AWS S3
อัปเดตล่าสุด: 3 มิถุนายน 2026
สามารถใช้ได้กับการสมัครใช้บริการใดๆ ต่อไปนี้ ยกเว้นที่ระบุไว้:
-
Data Hub Enterprise
เชื่อมต่อ HubSpot และ AWS S3 เพื่อซิงค์ข้อมูล HubSpot กับที่เก็บข้อมูล S3 หลังจากเชื่อมต่อแอปแล้ว HubSpot สามารถซิงค์ข้อมูล CRM รวมถึงออบเจ็กต์ระเบียนการเชื่อมโยงกิจกรรมและเซกเมนต์กับ AWS S3 สำหรับการจัดเก็บการรายงานและการวิเคราะห์
ตัวอย่างเช่นคุณสามารถซิงค์ข้อมูลผู้ติดต่อและข้อมูลบริษัทไปยังบักเก็ต S3 และใช้ในคลังข้อมูลเครื่องมือข่าวกรองทางธุรกิจหรือเวิร์กโฟลว์การประมวลผลข้อมูลขององค์กรของคุณได้
โปรดทราบ: HubSpot ไม่ได้ แชร์ข้อมูล HIPAA กับ AWS S3
ก่อนที่คุณจะเริ่มต้น
ก่อนที่จะตั้งค่าการผสานรวมคุณจะต้อง เลือกใช้บัญชี HubSpot ของคุณ ในการเข้าถึงข้อมูล HubSpot ในเบต้า AWS S3
เชื่อมต่อ HubSpot และ AWS S3
ในการเชื่อมต่อ HubSpot และ AWS S3 คุณต้องทำตามขั้นตอนด้านล่างเพื่อ:
- กำหนดค่าสิทธิ์การเข้าถึงสำหรับบักเก็ต AWS S3
- สร้างนโยบาย IAM
- สร้างบทบาท IAM ใน AWS
- เชื่อมต่อ HubSpot และ AWS S3
- ให้สิทธิ์ผู้ใช้ IAM ในการเข้าถึงออบเจ็กต์ S3 BUCK
1. กำหนดค่าสิทธิ์การเข้าถึงสำหรับบักเก็ต S3
HubSpot ต้องการสิทธิ์ต่อไปนี้ในบักเก็ตและโฟลเดอร์ AWS S3 เพื่อเข้าถึงไฟล์ในโฟลเดอร์และโฟลเดอร์ย่อย:
- s3: GetBucketLocation
- s3: GetObject
- s3: GetObjectVersion
- s3: ListBucket
- s3: PutObject
- s3: ลบวัตถุ
2. สร้างนโยบาย IAM
- เข้าสู่ระบบ AWS Management Console
- บนแดชบอร์ดหน้าแรกให้คลิกการ > รักษาความปลอดภัยบริการ ข้อมูลประจำตัว> IAM & การปฏิบัติตามกฎระเบียบ
- คลิกการตั้งค่าบัญชีที่แถบด้านซ้าย
- ในส่วนบริการโทเค็นความปลอดภัย (STS) ให้มองหาภูมิภาค AWS ที่สอดคล้องกับภูมิภาคที่บัญชี AWS ของคุณตั้งอยู่ คลิกเพื่อ เปิด สวิตช์เพื่อเปิดใช้งานภูมิภาค
- ที่แผงด้านซ้ายให้คลิกนโยบาย
- คลิกสร้างนโยบาย
- บนแท็บ JSON ให้คลิกเพิ่มคำสั่งใหม่
- เพิ่มเอกสารนโยบายด้านล่างที่จะให้สิทธิ์แก่ HubSpot ที่จำเป็นในการโหลดหรือยกเลิกการโหลดข้อมูลโดยใช้เส้นทางที่เก็บและโฟลเดอร์เดียว นอกจากนี้คุณยังสามารถล้างไฟล์ข้อมูลโดยใช้ตัวเลือกการคัดลอกการล้าง
โปรดทราบว่า:
- ตรวจสอบให้แน่ใจว่าได้
<prefix>เปลี่ยน<bucket>และใช้ชื่อถังและคำนำหน้าเส้นทางโฟลเดอร์จริงของคุณ ชื่อทรัพยากรอเมซอน (ARN) สำหรับที่เก็บข้อมูลในภูมิภาคของรัฐบาลมี ARN: aws-us-gov: s3::: คำนำหน้า - การตั้งค่า
s3:prefixเงื่อนไขเป็น ["*"] หรือ ["<path>/*"] ให้สิทธิ์การเข้าถึงคำนำหน้าทั้งหมดในถังหรือเส้นทางที่ระบุในถังตามลำดับ
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:GetObjectVersion",
"s3:DeleteObject",
"s3:DeleteObjectVersion"
],
"Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
},
{
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation"
],
"Resource": "arn:aws:s3:::<bucket>",
"Condition": {
"StringLike": {
"s3:prefix": [
"<prefix>/*"
]
}
}
}
]}
- คลิกถัดไป
- ในส่วนตรวจสอบและสร้าง ให้เพิ่ม ชื่อนโยบาย และคำอธิบายที่เลือกระบุได้
- คลิกสร้างนโยบาย
3. สร้างบทบาท IAM ใน AWS
ในการกำหนดค่าสิทธิ์การเข้าถึงสำหรับ HubSpot ใน AWS Management Console:
- เข้าสู่ระบบ AWS Management Console
- บนแดชบอร์ดหน้าแรกให้คลิกการ > รักษาความปลอดภัยบริการ ข้อมูลประจำตัว> IAM & การปฏิบัติตามกฎระเบียบ
- บนแถบด้านข้างซ้ายให้คลิกบทบาท
- คลิกสร้างบทบาท
- ในส่วนประเภทเอนทิตีที่เชื่อถือได้ ให้เลือกบัญชี AWS
- ในส่วนบัญชี AWS ให้เลือกบัญชี AWS อื่น แล้วป้อน ID บัญชี AWS ของคุณเอง ในภายหลังคุณจะเปลี่ยนความสัมพันธ์ของความไว้วางใจเพื่อให้สิทธิ์การเข้าถึง HubSpot
- เลือกต้องมี ID ภายนอก และป้อน ID ตัวยึดตำแหน่งเช่น 0000 ในภายหลังคุณจะเปลี่ยนความสัมพันธ์ความไว้วางใจสำหรับบทบาท IAM ของคุณและระบุ ID ภายนอกสำหรับการผสานรวมพื้นที่เก็บข้อมูลของคุณ ID ภายนอกจะใช้เพื่อให้สิทธิ์การเข้าถึงทรัพยากร AWS ของคุณไปยังแอปของบุคคลที่สามเช่น HubSpot
- คลิกถัดไป
- เลือกนโยบายที่สร้างขึ้นในขั้นตอนที่ 1 แล้วคลิกถัดไป
- ในส่วนรายละเอียดบทบาท ให้ป้อนชื่อบทบาท และคำอธิบาย เพื่อระบุบทบาท
- คลิกสร้างบทบาท
- ใน หน้าสรุปบทบาทให้คัดลอกค่า ARN คุณจะใช้ค่านี้ในขั้นตอนถัดไป
4. เชื่อมต่อ HubSpot และ AWS S3
ก่อนที่จะติดตั้งการผสานรวมตรวจสอบให้แน่ใจว่าได้ เลือกใช้บัญชี HubSpot ของคุณในการเข้าถึงข้อมูล HubSpot ในเบต้า AWS S3- ในบัญชี HubSpot ของคุณ ให้คลิกไอคอนตลาด
ในแถบนำทางด้านบน จากนั้นเลือก HubSpot Marketplace - ค้นหาและเลือก AWS S3
- คลิก ติดตั้ง
- ป้อน ชื่อบทบาท IAM ที่กำหนดค่าไว้ในขั้นตอนที่ 3 และเส้นทาง URL S3 สำหรับที่เก็บข้อมูลที่คุณต้องการเก็บไว้
- คลิก ถัดไป
- ตรวจสอบและคัดลอกค่า AWS IAM User และ AWS External ID ตามที่คุณต้องการในขั้นตอนต่อไป จากนั้นคลิก ดำเนินการต่อไปยังแอปที่เชื่อมต่อ
5. ให้สิทธิ์ผู้ใช้ IAM ในการเข้าถึงออบเจ็กต์ถัง
- เข้าสู่ระบบ AWS Management Console
- บนแดชบอร์ดหน้าแรกให้คลิกการ > รักษาความปลอดภัยบริการ ข้อมูลประจำตัว> IAM & การปฏิบัติตามกฎระเบียบ
- ในแถบด้านข้างซ้ายให้คลิกบทบาท
- เลือกบทบาทที่คุณสร้างขึ้นในขั้นตอนที่ 3
- เลือกแท็บความสัมพันธ์ความไว้วางใจ แล้วคลิกแก้ไขนโยบายความไว้วางใจ
- แก้ไขเอกสารกรมธรรม์ด้วยค่าที่คุณบันทึกไว้ในขั้นตอนที่ 3
{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "AWS": "<hubspot_user_arn>" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "sts:ExternalId": "<hubspot_external_id>" } } } ]}
- ในนโยบายข้างต้นให้เปลี่ยนสองฟิลด์ต่อไปนี้เป็นค่าที่คุณบันทึกไว้จากขั้นตอนที่ 4:
-
- hubspot_user_arn ไปยังค่า STORAGE_AWS_IAM_USER_ARN
- hubspot_external_id ไปยังค่า STORAGE_AWS_EXTERNAL_ID
หลังจากทำตามขั้นตอนข้างต้นเสร็จแล้ว HubSpot สามารถซิงค์ข้อมูลลงใน AWS S3 ได้
รูปแบบข้อมูลสำหรับการซิงค์ระหว่าง HubSpot และ AWS S3
ข้อมูลที่มีอยู่สำหรับการซิงค์
คุณสามารถซิงค์ข้อมูลต่อไปนี้จาก HubSpot ไปยัง AWS S3:
- วัตถุ: วัตถุมาตรฐานและวัตถุที่กำหนดเองเช่นรายชื่อผู้ติดต่อบริษัทตั๋วหรือผลิตภัณฑ์
- เรคคอร์ด: เรคคอร์ด วัตถุแต่ละรายการ
- การเชื่อมโยง: ทุกประเภทการเชื่อมโยงและบันทึกที่เกี่ยวข้อง
- กิจกรรม: ข้อมูลกิจกรรมสำหรับทั้งกิจกรรม HubSpot มาตรฐานและกิจกรรมพฤติกรรมที่กำหนดเอง
- เซกเมนต์: ผู้ติดต่อ HubSpot และเซกเมนต์บริษัท
- เจ้าของ: เจ้าของเรคคอร์ด
- ท่อ: ท่อข้อตกลงและตั๋วและขั้นตอนท่อ
- พร็อพเพอร์ตี้: พร็อพเพอร์ตี้และค่าของพร็อพเพอร์ตี้ในบันทึกวัตถุรวมถึงประวัติพร็อพเพอร์
ข้อมูลวัตถุประเภทต่างๆได้รับการจัดระเบียบและมีให้เลือกสองวิธี:
- บุคคล: ประเภทวัตถุ e ach จะถูกเก็บไว้ในตารางของตัวเองและมีเพียงระเบียนของประเภทวัตถุเดียวกันเท่านั้น ตัวอย่างเช่น objects_contacts มีเพียงบันทึกการติดต่อเท่านั้น
- รวมกัน: ระเบียน ll สำหรับทุกประเภทออบเจ็กต์จะรวมกันเป็นออบเจ็กต์ฐานข้อมูลเดียว ดังนั้นเมื่อสอบถามคุณต้องระบุตัวกรองเช่น “WHERE objectTypeId =' 0 -1 ’
วัตถุที่กำหนดเองจะถูกกำหนด ID ในขณะที่สร้างและจะถูกระบุเป็น 2 - UNIQUE_ID ตัวอย่างเช่น 2 -12345
object_x ตาราง
วัตถุแต่ละประเภทที่มีอยู่รวมถึงวัตถุที่กำหนดเองมีตารางเฉพาะของตัวเอง ตารางเหล่านี้ถูกตั้งชื่อตามรูป <object type name> แบบ OBJECTS_<object type name> โดยที่ป้ายชื่อรูปแบบพหูพจน์ objecttypeของ โปรดทราบว่าหากประเภทวัตถุไม่มีรูปแบบพหูพจน์ <object type name> จะเป็นฉลากรูปแบบเอกพจน์ของชื่อประเภทวัตถุที่เชื่อมต่อกับ “S”
ด้านล่างนี้คือรายการประเภทออบเจ็กต์ HubSpot ที่มีอยู่ทั้งหมดคำอธิบายสั้นๆเกี่ยวกับข้อมูลที่พวกเขาแสดงและตารางที่เกี่ยวข้อง
object_with_object_properties
ตารางนี้มีข้อมูลจากระเบียน HubSpot ของคุณ คุณสามารถรับหนึ่งแถวสำหรับแต่ละระเบียนภายในประเภทอ็อบเจกต์ (เช่นระเบียนผู้ติดต่อทั้งหมดในประเภทอ็อบเจ็กต์ผู้ติดต่อ)
object_properties_history
ตารางนี้มีค่าคุณสมบัติในอดีต สำหรับผู้ติดต่อจะมี 45 ค่าล่าสุด สำหรับออบเจ็กต์อื่นๆทั้งหมดจะมี 20 ค่าล่าสุด ตารางมีแถวสำหรับแต่ละมูลค่าทรัพย์สินในอดีต มูลค่าปัจจุบันของทรัพย์สินจะถูกกำหนดโดยการประทับเวลา UPDATEDAT ล่าสุดในประวัติของทรัพย์สิน
ข้อซักถามของสมาคม
เช่นเดียวกับข้อมูลออบเจ็กต์ข้อมูลการเชื่อมโยงจะถูกจัดระเบียบในสองวิธี:
- บุคคล: แต่ละประเภทการเชื่อมโยงจะถูกจัดเก็บไว้ในตารางของตัวเองและมีเพียงระเบียนประเภทนั้นเท่านั้น ตัวอย่างเช่น
associations_contacts_to_dealsมีเฉพาะระเบียนการเชื่อมโยงระหว่างการติดต่อและการจัดการวัตถุ T - รวมกัน: ระเบียนทั้งหมดสำหรับประเภทการเชื่อมโยงทั้งหมดจะรวมกันเป็นตารางเดียว
associations_x_to_y
แต่ละประเภทการเชื่อมโยงมีมุมมองของตัวเองที่ติดฉลากเป็น associations_<association type name> ตัวอย่าง associations_contacts_to_dealsเช่น
association_definitions
ตารางนี้มีข้อมูลเกี่ยวกับประเภทการเชื่อมโยงที่มีอยู่ทั้งหมดระหว่างออบเจ็กต์ HubSpot โดยมีหนึ่งแถวต่อประเภทการเชื่อมโยง
property_definitions
ตารางนี้มีข้อมูลเกี่ยวกับคุณสมบัติวัตถุและคุณสมบัติกิจกรรมในบัญชี HubSpot ของคุณ คุณสมบัติของกิจกรรมรวมถึงกิจกรรมมาตรฐานเช่นการเปิดและคลิกอีเมลและคุณสมบัติของกิจกรรมพฤติกรรมที่กำหนดเอง ข้อมูลนี้จะเป็นประโยชน์สำหรับการกำหนดค่าที่พบในข้อมูล object_properties และเหตุการณ์
กิจกรรม
กิจกรรมรวมถึงกิจกรรม HubSpot มาตรฐานและกิจกรรมพฤติกรรมที่กำหนดเอง แต่ละกิจกรรมมีตารางของตัวเองซึ่งมีป้ายกำกับ events_eventnameว่า
object_and_event_type_definitions
ตารางนี้มีคำจำกัดความสำหรับออบเจ็กต์และกิจกรรมทั้งหมดที่มีอยู่ในบัญชี HubSpot ของคุณ
ความถี่ในการซิงค์และการจัดระเบียบข้อมูล
ซิงค์ข้อมูลทุกวัน ระหว่าง HubSpot และ AWS S3 โฟลเดอร์จะถูกสร้างขึ้นสำหรับแต่ละวันที่ซิงค์ข้อมูล แต่ละตารางต่อไปนี้จะพร้อมใช้งานเป็นโฟลเดอร์ที่มีไฟล์ CSV แบบ gzipped:
ASSOCIATIONSASSOCIATION_DEFINITIONSEVENTS_[Event name]LISTSLIST_MEMBERSHIPSOBJECTSOBJECT_AND_EVENT_TYPE_DEFINITIONSOBJECT_PROPERTIESOBJECT_PROPERTIES_HISTORYOBJECT_WITH_OBJECT_PROPERTIESOWNERSOWNER_TEAMPIPELINESPIPELINE_STAGESPROPERTY_DEFINITIONSTEAMS
จะมีโฟลเดอร์ย่อยหลายโฟลเดอร์สำหรับแต่ละตาราง หากขนาดของตารางเกิน 15 MB จะมีไฟล์ gzipped CSV หลายไฟล์ภายใต้แต่ละโฟลเดอร์ตาราง