Salesforce Lightning Email 한글 깨짐 원인과 해결 방법 (UTF-8 설정)

세일즈포스에서 라이트닝 이메일을 사용하다 보면, 실제 발송된 메일 내용이 깨지는 경우가 있다.

특히 한글이 포함된 경우라면 인코딩 문제가 원인일 가능성이 높다.

문제 원인

라이트닝 이메일 템플릿은 클래식 이메일 템플릿처럼 인코딩을 직접 설정하는 UI가 보이지 않는다.
다만 공식 문서를 보면 Lightning 이메일 템플릿은 Encoding 필드를 사용하지 않고, 발송 사용자의 Email Encoding 설정을 따를 수 있다고 안내한다. 그래서 실제로는 템플릿 설정 문제일 수도 있고, 사용자 개인 설정 문제일 수도 있다.

해결 방법

1) 발송 사용자 Email Encoding 확인

먼저 메일을 보내는 사용자의 개인 설정에서 Email Encoding 값이 Unicode (UTF-8)인지 확인한다. Salesforce Help에서도 비서구권 문자를 보내는 경우 UTF-8 사용을 권장한다

2) 라이트닝 이메일 템플릿 Encoding 값 수정

개발자 콘솔의 Execute Anonymous에서 EmailTemplate개체의 Encoding필드를 UTF-8로 변경한다.

EmailTemplate t = [
  SELECT Id, Name, Encoding
  FROM EmailTemplate
  WHERE DeveloperName = 'EmailTemplate_183240100671' // DeveloperName: 적절한 값으로 변경
  LIMIT 1
];

t.Encoding = 'UTF-8';
update t;