주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..
프로그래밍 가능한 이메일 생성
마지막 업데이트 날짜: 2026년 9월 21일
프로그래밍 가능한 이메일을 사용하면 고급 HubL 구문을 활용해 이메일 내용을 개인화할 수 있습니다. HubSpot 개발자 문서의 모듈에서 CRM 데이터 활용 방법에 대해 자세히 알아보세요.
제한 사항 및 고려 사항 이해하기
- 프로그래밍 가능한 이메일에서 사용할 수 있는 데이터는 HubSpot 구독 유형에 따라 다릅니다.
- Marketing Hub Professional 계정을 보유한 경우, 연락처, 기업, 제품과 같은 표준 CRM 개체의 데이터를 렌더링할 수 있습니다.
- Marketing Hub Enterprise 구독을 사용 중인 경우, 프로그래밍 가능한 이메일에 HubDB 테이블 및 사용자 정의 개체와 같은 구조화된 데이터 소스를 포함할 수 있습니다.
- 프로그래밍 가능한 이메일에 추가할 수 있는 CRM 함수의 수는 수신자 수에 따라 달라집니다:
- CRM 기능이 5개 포함된 이메일은 최대 100,000명의 수신자에게 발송할 수 있습니다. 프로그래밍 가능한 이메일에는 CRM 기능을 5개 이하로만 추가할 수 있습니다.
- CRM 기능이 4개인 이메일은 최대 125,000명의 수신자에게 발송할 수 있습니다.
- CRM 기능이 3개인 이메일은 최대 165,000명의 수신자에게 발송할 수 있습니다.
- CRM 기능이 2개인 이메일은 최대 250,000명의 수신자에게 발송할 수 있습니다.
- CRM 기능이 1개 포함된 이메일은 최대 500,000명의 수신자에게 발송할 수 있습니다.
- CRM 기능이 포함된 프로그래밍 가능한 이메일은 최소 1시간 간격을 두고 발송해야 합니다.
모듈이나 템플릿에 프로그래밍 가능한 이메일을 추가하세요
디자인 관리자에서 프로그래밍 가능한 이메일에 사용할 수 있는 사용자 지정 모듈과 사용자 지정 코드가 포함된 템플릿을 만들 수 있습니다.
프로그래밍 가능한 이메일을 지원하는 사용자 지정 모듈을 생성한 후에는 드래그 앤 드롭 편집기에서 생성된 이메일에 해당 모듈을 추가할 수 있습니다.
프로그래밍 가능한 이메일 모듈 만들기
권한 필요 디자인 관리자에서 모듈을 생성하려면 디자인 도구 권한이 필요합니다.
- HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > 디자인 관리자로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > 디자인 관리자로 이동하세요.
- 왼쪽 열에서 파일 메뉴를 클릭하고 새 파일을 선택합니다.
- 대화 상자에서 드롭다운 메뉴를 클릭하고 ‘모듈’을 선택한 다음 ‘다음’을 클릭합니다.
- '이 모듈을 어디에서 사용하시겠습니까?' 섹션에서 '이메일' 확인란을 선택합니다.
- '파일 이름' 필드에 모듈 이름을 입력합니다.
- '만들기'를 클릭합니다.
- 오른쪽 열에서 ‘프로그래밍 가능한 이메일에 모듈 사용’ 스위치를 켭니다.

- 대화 상자에서 발송 제한 사항을 확인한 다음, '동의하고 켜기'를 클릭합니다.
프로그래밍 가능한 이메일 코드 템플릿 만들기
권한 필요 디자인 관리자에서 템플릿을 생성하려면 디자인 도구 권한이 필요합니다.
- HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > 디자인 관리자로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > 디자인 관리자로 이동하세요.
- 왼쪽 열에서 ‘파일’ 메뉴 를 클릭하고 ‘새 파일’을 선택합니다.
- 대화 상자에서 드롭다운 메뉴를 클릭하고 ‘HTML + HubL’을 선택한 다음, ‘다음’을 클릭합니다.
- '템플릿 유형' 드롭다운 메뉴를 클릭하고 '이메일'을 선택합니다.
- '파일 이름' 필드에 템플릿 이름을 입력합니다.
- '만들기'를 클릭합니다.
- 코딩된 템플릿의 상단에서
<!--과-->사이의 섹션에 다음 코드를 추가합니다.isEnabledForEmailV3Rendering: true.

- 템플릿 편집을 마친 후, 오른쪽 상단의 변경 사항 게시를 클릭합니다.
프로그래밍 가능한 이메일 최적화
프로그래밍 가능한 이메일을 보낼 때 발송 지연이 발생하지 않도록 하려면 다음 모범 사례를 따르는 것이 좋습니다.
- 가능한 경우 일반 이메일을 사용하십시오: 수신자가 정해져 있고 정해진 시간에 이메일을 발송할 때는 성능 향상을 위해 자동 이메일 대신 일반 이메일을 발송하는 것이 좋습니다
- 너무 많은 행이 가져오지 않도록 쿼리를 추가하세요:
hubdb_table_rows를 설정할 때, 가져올 행을 좁히기 위해 쿼리를 추가하세요.- 예시:
years_at_company값이 3보다 큰 연락처 행을 필터링하고, 반환되는 결과를 15개로 제한할 수 있습니다. hubdb_table_rows(1546258, "years_at_company__gt=3&limit=15")
- 예시:
- 개인화 토큰을 사용한 필터링은 피하십시오: 쿼리 매개변수 내 필터링이나 가져온 후 필터링을 포함하여, 데이터 행을 필터링하는 데 개인화 토큰을 사용하는 것은 피하는 것이 좋습니다.
- 개인화 토큰을 사용한 필터링을 피할 수 없는 경우, 가져오는 행 수를 최소화하는 것을 우선으로 하고, 데이터가 검색된 후
if구문을 사용하여 조건부 필터링을 적용하는 것이 좋습니다. - 예: 가져오는 행 수를 20개로 제한한 다음, 데이터를 가져온 후 `
row.location = contact.location`을 사용하여 필터링할 수 있습니다.
- 개인화 토큰을 사용한 필터링을 피할 수 없는 경우, 가져오는 행 수를 최소화하는 것을 우선으로 하고, 데이터가 검색된 후

- CRM 함수 호출 횟수 제한: 이메일 내 CRM 함수(예:
crm_object및crm_associations)의 횟수는 수신자 수에 따라 달라집니다. 지연이나 취소를 방지하기 위해 이러한 함수의 호출 횟수를 제한하십시오.- 예시: CRM 함수 호출 횟수에 대해 명확한 제한을 설정하십시오.

BETA
Marketing Email
피드백을 보내 주셔서 감사합니다. 당사에 큰 도움이 될 것입니다.
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.
