콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

프로그래밍 가능한 이메일 생성

마지막 업데이트 날짜: 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시간 간격을 두고 발송해야 합니다.

모듈이나 템플릿에 프로그래밍 가능한 이메일을 추가하세요

디자인 관리자에서 프로그래밍 가능한 이메일에 사용할 수 있는 사용자 지정 모듈과 사용자 지정 코드가 포함된 템플릿을 만들 수 있습니다.

프로그래밍 가능한 이메일을 지원하는 사용자 지정 모듈을 생성한 후에는 드래그 앤 드롭 편집기에서 생성된 이메일에 해당 모듈을 추가할 수 있습니다.

프로그래밍 가능한 이메일 모듈 만들기

권한 필요 디자인 관리자에서 모듈을 생성하려면 디자인 도구 권한이 필요합니다.

  1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > 디자인 관리자로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > 디자인 관리자로 이동하세요.
  2. 왼쪽 열에서 파일 메뉴를 클릭하고 새 파일을 선택합니다.
  3. 대화 상자에서 드롭다운 메뉴를 클릭하고 ‘모듈’을 선택한 다음 ‘다음’을 클릭합니다.
  4. '이 모듈을 어디에서 사용하시겠습니까?' 섹션에서 '이메일' 확인란을 선택합니다.
  5. '파일 이름' 필드에 모듈 이름을 입력합니다.
  6. '만들기'를 클릭합니다.
  7. 오른쪽 열에서 ‘프로그래밍 가능한 이메일에 모듈 사용’ 스위치를 켭니다.

Screenshot of the right column of the design manager. The "Use module for programmable email" switch is highlighted.

  1. 대화 상자에서 발송 제한 사항을 확인한 다음, '동의하고 켜기'를 클릭합니다.

프로그래밍 가능한 이메일 코드 템플릿 만들기

권한 필요 디자인 관리자에서 템플릿을 생성하려면 디자인 도구 권한이 필요합니다.


  1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > 디자인 관리자로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > 디자인 관리자로 이동하세요.
  2. 왼쪽 열에서 ‘파일 메뉴 를 클릭하고 ‘새 파일’을 선택합니다.
  3. 대화 상자에서 드롭다운 메뉴를 클릭하고 ‘HTML + HubL’을 선택한 다음, ‘다음’을 클릭합니다.
  4. '템플릿 유형' 드롭다운 메뉴를 클릭하고 '이메일'을 선택합니다.
  5. '파일 이름' 필드에 템플릿 이름을 입력합니다.
  6. '만들기'를 클릭합니다.
  7. 코딩된 템플릿의 상단에서 <!----> 사이의 섹션에 다음 코드를 추가합니다. isEnabledForEmailV3Rendering: true.

A screenshot of the top section of a custom coded email template. The code for using the template for programmable emails is indicated.

  1. 템플릿 편집을 마친 후, 오른쪽 상단의 변경 사항 게시를 클릭합니다.

프로그래밍 가능한 이메일 최적화

프로그래밍 가능한 이메일을 보낼 때 발송 지연이 발생하지 않도록 하려면 다음 모범 사례를 따르는 것이 좋습니다.

  • 가능한 경우 일반 이메일을 사용하십시오: 수신자가 정해져 있고 정해진 시간에 이메일을 발송할 때는 성능 향상을 위해 자동 이메일 대신 일반 이메일을 발송하는 것이 좋습니다
  • 너무 많은 행이 가져오지 않도록 쿼리를 추가하세요: 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`을 사용하여 필터링할 수 있습니다.

Example code for avoid filtering by personalization tokens

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

Example code for limiting the number of calls of CRM functions

이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.