통신 템플릿 관리

통신 템플릿은 이메일, SMS, 시스템 알림, 인증 메시지, 청구서, 결제 안내, 기타 자동 발송 메시지에 사용하는 재사용 가능한 메시지 양식입니다.

이 화면에서는 제공업체, 채널, 상태, 정렬 순서에 따라 메시지 템플릿을 생성하고 관리할 수 있습니다. 템플릿은 사용자 또는 관리자에게 발송되는 제목과 본문 내용을 정의합니다.

화면 개요

Communication Templates 화면은 iBoard에서 반복적으로 사용하는 메시지 내용을 관리하는 곳입니다. 같은 메시지를 매번 작성하지 않고, 템플릿으로 만들어 여러 시스템 이벤트와 통신 채널에서 재사용할 수 있습니다.

영역	설명
검색 필터	키워드, 제공업체, 채널, 상태를 기준으로 템플릿을 검색합니다.
템플릿 요약	전체, 활성, 비활성 템플릿 수를 보여줍니다.
템플릿 목록	등록된 통신 템플릿 목록을 보여줍니다.
템플릿 편집	통신 템플릿을 생성하거나 수정하는 화면입니다.
본문 템플릿	실제로 발송될 제목과 본문 내용을 작성합니다.

주요 버튼

버튼	기능
Create Template	새 통신 템플릿을 생성합니다.
Search	선택한 검색 조건을 적용하여 템플릿 목록을 조회합니다.
Back to List	편집 화면에서 템플릿 목록으로 돌아갑니다.

검색 필터

검색 필터를 사용하면 원하는 통신 템플릿을 빠르게 찾을 수 있습니다.

필터	설명
Keyword	템플릿 코드 또는 템플릿 이름으로 검색합니다.
Provider	통신 제공업체 기준으로 템플릿을 필터링합니다.
Channel	Email, SMS 같은 채널 기준으로 필터링합니다.
Status	활성 또는 비활성 상태를 기준으로 필터링합니다.

템플릿 목록

Template List에는 현재 검색 조건에 맞는 템플릿 목록이 표시됩니다.

컬럼	설명
ID	내부 템플릿 ID입니다.
Code	시스템에서 사용하는 고유 템플릿 코드입니다.
Name	관리자가 보기 쉬운 템플릿 이름입니다.
Provider	이 템플릿과 연결된 통신 제공업체입니다.
Channel	Email 또는 SMS 같은 통신 채널입니다.
Status	템플릿이 활성 상태인지 비활성 상태인지 보여줍니다.
Sort	표시 순서 또는 우선순위를 제어합니다.
Action	수정, 삭제 등 가능한 관리 작업을 제공합니다.

템플릿 생성 방법

Create Template 버튼을 클릭합니다.
Template Code와 Template Name을 입력합니다.
Provider를 선택합니다.
Channel Type을 선택합니다.
Subject Template을 입력합니다.
본문 편집기에서 Body Template을 작성합니다.
Sort Order를 입력합니다.
사용 준비가 완료되면 Active 상태로 변경합니다.
템플릿을 저장합니다.

Template Edit 화면

Template Edit 화면에서는 템플릿 기본 정보, 제공업체 연결, 채널 연결, 제목 내용, 본문 내용, 상태, 정렬 순서를 설정합니다.

Basic Information

항목	설명
Template Code	시스템 내부에서 사용하는 고유 코드입니다. 템플릿 목적을 알 수 있도록 명확하게 작성하는 것이 좋습니다. 예: `EMAIL_VERIFY_CODE`, `ORDER_CONFIRMATION`, `PASSWORD_RESET`
Template Name	관리자가 보기 쉬운 템플릿 표시 이름입니다.
Provider	이 템플릿을 발송할 통신 제공업체입니다. 제공업체를 선택하지 않으면 메시지가 정상적으로 발송되지 않을 수 있습니다.
Channel Type	이 템플릿의 통신 채널입니다. 예: Email, SMS
Subject Template	이메일 발송 시 사용되는 제목입니다. SMS 템플릿은 제목이 필요하지 않을 수 있습니다.
Sort Order	표시 순서 또는 우선순위를 설정합니다.
Active	이 템플릿을 시스템에서 사용할 수 있는지 결정합니다.

Content Template

Content Template 영역은 사용자에게 실제로 발송되는 메시지 본문을 작성하는 곳입니다. 편집기를 사용하여 텍스트 서식, 링크, 표, 버튼, HTML 이메일 본문 등을 작성할 수 있습니다.

Body Template 편집기

본문 편집기는 리치 텍스트 편집 기능을 제공합니다. 설정에 따라 서식, 정렬, 목록, 링크, 표, 미리보기, HTML 모드 등을 사용할 수 있습니다.

편집 도구	기능
Paragraph / Font / Size	문단 스타일, 글꼴, 글자 크기를 조정합니다.
Bold / Italic / Underline	굵게, 기울임, 밑줄 등 기본 텍스트 서식을 적용합니다.
Alignment	본문 내용을 왼쪽, 가운데, 오른쪽으로 정렬합니다.
List	글머리표 또는 번호 목록을 만듭니다.
Link	메시지 본문에 클릭 가능한 링크를 삽입합니다.
Table	템플릿에 표를 삽입합니다.
HTML / Code View	필요한 경우 HTML 내용을 직접 수정할 수 있습니다.
Preview	저장 또는 발송 전에 메시지를 미리 확인합니다.

변수 사용

템플릿에는 고객명, 인증 코드, 주문 번호, 청구 금액, 결제 링크 같은 동적 값을 넣기 위해 변수를 사용할 수 있습니다.

사용할 수 있는 변수는 해당 템플릿을 발송하는 시스템 기능에 따라 달라집니다. 반드시 해당 발송 기능에서 지원하는 변수만 사용하세요.

자주 사용하는 변수 예시

{CustomerName}
{UserName}
{VerificationCode}
{OrderNumber}
{InvoiceNumber}
{PaymentAmount}
{PaymentLink}
{LoginUrl}
{SiteName}
{CurrentDate}

Subject Template 예시

Your verification code is {VerificationCode}

이메일 본문 예시

Hello {CustomerName},

Your verification code is:

{VerificationCode}

This code will expire soon.

Thank you,
{SiteName}

HTML 이메일 예시

<h2>Hello {CustomerName},</h2>

<p>Your verification code is:</p>

<div style="font-size:28px;font-weight:bold;">
    {VerificationCode}
</div>

<p>Thank you,<br>{SiteName}</p>

이메일 템플릿 작성 기준

제목은 명확하게 작성하세요.
메시지는 짧고 이해하기 쉽게 작성하세요.
가장 중요한 정보는 본문 상단에 배치하세요.
연결된 제공업체의 인증된 발신자 정보를 사용하세요.
운영에 사용하기 전에 반드시 테스트 발송을 진행하세요.
거래성 이메일에는 불필요한 큰 이미지를 사용하지 않는 것이 좋습니다.

SMS 템플릿 작성 기준

SMS 템플릿은 짧게 작성하세요.
불필요한 서식이나 HTML을 포함하지 마세요.
일반 텍스트만 사용하는 것이 좋습니다.
가장 중요한 정보를 먼저 작성하세요.
SMS 제공업체가 메시지 구간 단위로 과금하는 경우 길이를 확인하세요.

권장 작업 순서

Admin > Provider > Template 메뉴로 이동합니다.
Create Template 버튼을 클릭합니다.
고유한 Template Code를 입력합니다.
명확한 Template Name을 입력합니다.
Provider와 Channel Type을 선택합니다.
Subject Template을 작성합니다.
편집기를 사용해 Body Template을 작성합니다.
필요한 경우 변수를 삽입합니다.
작성 중에는 Inactive 상태로 저장합니다.
연결된 제공업체로 테스트 발송을 진행합니다.
검증이 완료되면 Active 상태로 변경합니다.

자주 사용하는 템플릿 유형

템플릿 유형	용도
이메일 인증	사용자에게 인증 코드 또는 인증 링크를 발송합니다.
비밀번호 재설정	사용자가 비밀번호를 잊었을 때 재설정 링크 또는 코드를 보냅니다.
주문 확인	고객이 주문한 후 주문 내용을 발송합니다.
결제 영수증	결제 확인 및 영수증 정보를 발송합니다.
청구서 안내	고객에게 청구서 또는 결제 관련 정보를 발송합니다.
관리자 알림	관리자에게 내부 알림을 발송합니다.

주의사항

Template Code는 반드시 고유해야 합니다.
시스템 이벤트나 자동화에서 사용 중인 템플릿은 삭제하지 않는 것이 좋습니다.
비활성 템플릿은 실제 발송에 사용되지 않아야 합니다.
변수명은 발송 기능에서 사용하는 이름과 정확히 일치해야 합니다.
HTML 이메일은 가능하면 여러 이메일 클라이언트에서 테스트하세요.
비밀번호, API 키, 내부 보안 값 같은 민감한 정보를 템플릿 안에 직접 넣지 마세요.

문제 해결

문제	가능한 원인	해결 방법
템플릿이 보이지 않음	템플릿이 생성되지 않았거나 현재 검색 조건이 너무 제한적일 수 있습니다.	검색 조건을 초기화하거나 새 템플릿을 생성합니다.
템플릿이 발송되지 않음	템플릿이 비활성 상태이거나 활성 제공업체와 연결되지 않았을 수 있습니다.	템플릿 상태와 제공업체 설정을 확인합니다.
변수가 치환되지 않음	변수명이 잘못되었거나 해당 발송 기능에서 지원하지 않는 변수일 수 있습니다.	해당 기능에서 지원하는 정확한 변수명을 사용합니다.
이메일 레이아웃이 깨짐	HTML 코드가 일부 이메일 클라이언트와 호환되지 않을 수 있습니다.	HTML을 단순화하고 운영 전 테스트 발송을 진행합니다.
SMS 내용이 너무 김	메시지가 SMS 제공업체의 구간 제한을 초과할 수 있습니다.	문장을 줄이고 불필요한 내용을 제거합니다.

관리 권장 사항

Template Code 이름 규칙을 일관되게 유지하세요.
거래성 메시지는 짧고 직접적으로 작성하세요.
채널별로 별도의 템플릿을 사용하는 것이 좋습니다.
이메일 HTML 템플릿을 SMS용으로 그대로 사용하지 마세요.
모든 템플릿은 활성화 전 테스트하세요.
오래된 템플릿은 바로 삭제하지 말고 먼저 비활성 상태로 보관하세요.

통신 템플릿은 사용자가 실제로 받는 메시지를 결정합니다. 잘못된 템플릿은 혼란스러운 이메일, 누락된 인증 코드, 잘못된 결제 링크, 실패한 알림으로 이어질 수 있습니다.