Sendgrid-nodejs: 다국어 지원을 위해 템플릿 버전을 활용하는 방법

안녕하세요 @ ifndefdeadmau5 ,

이 기능에 대한 API 문서는 다음과 같습니다 . 이 SDK를 사용하여 API를 호출하는 방법은 다음과 같습니다 .

도움이 되었기를 바랍니다.

마음을 담아,

Elmer

@thinkingserious 나에게 돌아와 주셔서 감사합니다.

여전히 '특정 템플릿 버전 활성화'를 실제로 사용할 수있는 방법을 알 수 없습니다.
2 개 이상의 언어 (영어와 스페인어 등)로 작성된 2 가지 버전의 템플릿이 있다는 시나리오를 생각하고있었습니다.

그런 다음 사용자의 언어와 일치하는 특정 템플릿 버전으로 API 호출을 보내는 메시지를 만듭니다.

export function sendSendGridEmail()
{
  sgMail.setApiKey(config.get('sendgrid.API_KEY'));
  sgMail.setSubstitutionWrappers('{{', '}}');
  const msg = {
    to: '[email protected]',
    from: '[email protected]',
    subject: 'Sending with SendGrid is Fun',
    text: 'and easy to do anywhere, even with Node.js',
    html: '<strong>and easy to do anywhere, even with Node.js</strong>',
    templateId: isUserLocaleEnglish ? ENGLISH_TEMPLATE_ID : SPANISH_TEMPLATE_ID, // This line!
    substitutions: {
      name: 'Some One',
      city: 'Denver',
    },
  };
  sgMail.send(msg);
}

그러나 위의 예에는 다른 버전의 템플릿이 아닌 2 개의 별도 템플릿이 필요합니다. 별도의 템플릿을 생성 할 수 있지만 콘텐츠는 관련이 있습니다.
내가 여기서 무엇을 놓치고 있습니까? 저를 깨달으십시오.
다시 한 번 감사 드리며 여러분의 의견을 기다리겠습니다!

안녕하세요 @ ifndefdeadmau5 ,

템플릿 당 여러 버전을 가질 수 있습니다. 그런 다음 SDK를 사용하여 특정 버전을 활성화 할 수 있습니다.

먼저 여러 버전의 템플릿을 만듭니다. 그런 다음 위의 호출을하기 전에 원하는 버전을 활성화합니다.

마음을 담아,

Elmer

좋은 아침 @thinkingserious ,

귀하의 빠른 답변에 감사 드리며 그러한 해결 방법을 상상하지 못했습니다.
이제 나는 그것을하는 방법을 이해하지만, 한 가지 질문은 왜 처음에 모든 템플릿 버전을 활성화하지 않고 사용자가 활성화 / 비활성화를 신경 쓰지 않고 사용할 수 있도록하는 것입니다.

내 관심사는 서로 다른 언어를 사용하는 두 명 이상의 사용자가 동시에 (정확히 동일한) 작업을 수행하여 서버가 동시에 2 개의 요청을 처리해야하는 경우 어떻게 될까요? 그러면 어떤 템플릿 버전이 활성화됩니까?

아래는 내 상황을 알려주기 위해 서버 코드의 일부입니다.

export async function sendSendGridEmail() {
  const locale = 'ko';
  const isEnglishUser = locale === 'en';
  const PASSWORD_RESET_TEMPLATE_ID = '2096abb7-a9f8-413f-96a1-b9df0644b313';

  const { versions } = await getTemplate(PASSWORD_RESET_TEMPLATE_ID);
  const KO_VER = _.find(versions, { name: 'Korean' }).id;
  const EN_VER = _.find(versions, { name: 'English' }).id;

  await activateVersion(PASSWORD_RESET_TEMPLATE_ID, isEnglishUser ? EN_VER : KO_VER);

  sgMail.setSubstitutionWrappers('{{', '}}');
  const msg = {
    to: '[email protected]',
    from: '[email protected]',
    templateId: PASSWORD_RESET_TEMPLATE_ID,
    substitutions: {
      username: 'Test Username',
    },
  };
  sgMail.send(msg);
}

안녕하세요 @ ifndefdeadmau5 ,

그것은 유효한 관심사입니다.

정말로 필요한 것은 우리의 새로운 (베타) 템플릿 시스템 인 것 같습니다 . 베타에 참여하려면 [email protected]으로 이메일을 보내주십시오.

마음을 담아,

Elmer

안녕하세요 @thinkingserious ,

이메일을 통해 [email protected]으로 요청

또한 다른 로케일 별 이메일에 대해 템플릿 버전을 사용할 수있는 방법을 알아보기 위해 트랜잭션 템플릿 을 살펴보고있었습니다.
동의합니다. 특정 템플릿 버전을 사용하기 전에 활성화해야하는 것이 이상해 보입니다. 이것은 거래량이 많은 소프트웨어를위한 최상의 솔루션이 아닙니다. POST /mail/send 요청에 사용할 버전을 지정할 수있을 것으로 예상합니다.

안녕하세요 @ andyblack19
우리가 도입 한 새로운 템플릿으로 버전을 관리 할 필요가 없습니다. 계정에 "거래"템플릿 옵션이 표시됩니다. 여기에서 여러 언어를 지원하는 하나의 템플릿을 만들 수 있습니다. 여기 에있는 문서와 것 입니다.

나는 그 페이지를 읽었다. 그러나 다국어 섹션을 완전히 놓쳤다! 당신의 도움을 주셔서 감사합니다

위에서 언급 한 핸들 바 전략으로는 "디자인 편집기"모드 템플릿을 사용할 수없는 것 같습니다. 두 개 이상의 다른 언어로 서로 다른 사용 사례에 대한 여러 템플릿을 갖고 싶다면 일반 레이아웃이 변경 될 때 템플릿 코드를 각 템플릿에 복사하여 붙여 넣어야합니까? 공유 가능한 최상위 레이아웃을 가질 수없는 이유는 무엇입니까?

또한 각 언어에 대한 템플릿 본문 을 이미 설정하고있는 템플릿 콘텐츠 대신 서버 측에서 이메일 제목을 현지화해야하는 것 같습니다. 이런 식으로 주제와 본문을 분리하는 것은 이치에 맞지 않습니다. 아니면 내가 간과 한 것이 있습니까?

안녕하세요 @raine

위에서 언급 한 핸들 바 전략으로는 "디자인 편집기"모드 템플릿을 사용할 수없는 것 같습니다.

여기 에있는 언어 템플릿의 특정 디자인은 "디자인 편집기"모드에서 작동하도록 디자인되지 않았습니다. 코드 모듈을 사용하여 "디자인 편집기"에서 비슷한 것을 만들 수 있습니다.

두 개 이상의 다른 언어로 서로 다른 사용 사례에 대한 여러 템플릿을 갖고 싶다면 일반 레이아웃이 변경 될 때 템플릿 코드를 각 템플릿에 복사하여 붙여 넣어야합니까? 공유 가능한 최상위 레이아웃을 가질 수없는 이유는 무엇입니까?

이것은 실제로 우리 엔지니어들에게 제기 된 것입니다. 계정에 로그인 한 상태에서 피드백 버튼을 사용하여 Google 엔지니어에게 이것이 원한다는 사실을 알리는 것이 좋습니다. 이와 같은 피드백을 제출하는 사람들이 많을수록 우리는 이와 같은 개선을 볼 가능성이 높아집니다. 피드백 버튼은 코드 라이브러리 외부에있는 경우 엔지니어에게 직접 피드백을받을 수있는 가장 좋은 방법 중 하나입니다. 나는 개인적으로 당신이 찾고있는 것과 비슷한 것에 대해 투표를했습니다.

또한 각 언어에 대한 템플릿 본문을 이미 설정하고있는 템플릿 콘텐츠 대신 서버 측에서 이메일 제목을 현지화해야하는 것 같습니다. 이런 식으로 주제와 본문을 분리하는 것은 이치에 맞지 않습니다. 아니면 내가 간과 한 것이 있습니까?

나는 당신이 뭔가를 간과했다고 생각합니다. 개인 테스트를 통해 핸들 바가 템플릿의 주제를 설정하는 데 사용된다는 것을 알고 있습니다. 나는 당신의 말을 정확하게 이해하지 못할 수도 있습니다. 나는 주제가 이것을 지원하도록 시각적으로 설계되지 않았다는 것을 알고 있으므로 텍스트 편집기와 같은 코드와 내용을 만들어서 제목 필드에 붙여 넣는 것이 가장 좋습니다. 피드백 버튼 사용이 권장되는 또 다른 영역입니다. 이 작업을 수행하는 더 나은 방법이라고 생각하는 것을 자유롭게 제안하십시오.

내가 실수 한 내용을 수정하고 더 잘 이해할 수 있도록 자세한 내용을 알려주세요.

카일

여러 언어의 예는 이메일 제목 줄의 번역을 어떻게 다룹니까?

뿡뿡

템플릿의 제목 줄에 다음과 같이 사용합니다.

{{#if english}}
Hello
{{else if spanish}}
Hola
{{else if french}}
Bonjour
{{/if}}

기본적으로 HTML 콘텐츠와 동일한 구조를 사용합니다. 추가 질문이 있으면 알려주십시오.

안녕하세요 @kylearoberts , 조건부에서 변수 값을 확인하는 방법이 있습니까? 따라서 english 또는 spanish 와 같은 여러 변수를 확인하는 대신 language 변수가 en 또는 es 와 같은지 확인합니다. 이것은 템플릿 자체에는 큰 차이가 없지만 언어 코드 변수를 동적 템플릿 데이터에서 특별히 명명 된 변수로 변환해야하는 백엔드에서는 수행됩니다.

잠시 핸들 바를 확인했는데 기본적으로 지원하지 않는 것 같습니다. 하지만 SendGrid에는 몇 가지 사용자 지정 도우미가 내장되어있을 수 있습니다.

뿡뿡

좋은 질문에 감사드립니다. 지금 당장은 시스템이 그런 식으로 작동하지 않을 것이지만 우리는 나중에 그런 것을 허용 할 무언가를 갖게 될 것입니다. 이러한 변경을 수행하면 트랜잭션 템플릿 사용 방법에 대한 문서와 예제를 업데이트 할 가능성이 높습니다.

안녕하세요,
현재 다국어 이메일에 새 템플릿 시스템을 사용하고 있습니다. 주요 문제는 제목 필드 제한 길이입니다. 기본적으로 내 주제 내용은 다음과 같습니다.

{{# 영어 인 경우}}
안녕 blah blah ...
{{else if spanish}}
안녕 blah blah ...
{{else if french}}
안녕 blah blah ...
{{/만약}}

그러나 몇 가지 문제가 있습니다.

1. 제목 필드 길이는 몇 개 이상의 언어에 충분하지 않습니다. 한계를 지키기 위해 텍스트와 변수 이름을 줄여야했습니다. 그러나 이것은 우리가 새로운 언어를 추가해야한다면 분명히 작동하지 않을 것입니다.
2. 편집기는 템플릿 주제 작업에 적합하지 않은 주제를 입력하기위한 한 줄 필드를 표시합니다.
3. 편집기 제목 필드는 붙여 넣기에서 입력 한 텍스트를 즐겁게 잘라냅니다. 템플릿 스크립팅 코드가 제거되어 구문이 잘못되므로 템플릿 오류가 발생합니다.

@bragma

나는 당신과 같은 문제에 직면했습니다. 우리가 이것을들은 것은 이번이 처음이 아닙니다. 제품 개선에 도움이되므로 이와 같은 피드백을 받고 싶습니다. 귀하의 피드백을 엔지니어링 팀에 확실히 전달했으며 이것이 개선하고자하는 영역 중 하나라고 말할 수 있습니다. 그들이 개선 작업을 할 수있는 기회를 얻었을 때 이것은 그들 중 하나 일 것입니다. 피드백에 다시 한번 감사드립니다.

@thinkingserious +1 현지화 기능이 필요합니다

이 기능에 대해 @thinkingserious 엄청난 +1.
동일한 템플릿 내에서 이메일의 모든 언어를 처리 할 수있는 정말 좋은 기능이지만 이전에 언급했듯이 제목 제한으로 인해 사용할 수 없습니다.

@thinkingserious 메가 + @thinkingserious 메가 + 맡기고 싶습니다. 따라서 언어별로 일반 WYSIWYG 템플릿이 필요합니다. 언어 당 하나의 별도 버전이 있으면 문제에 대한 답이 될 것입니다.

다음이 더 좋습니다.

1-기본 버전을 설정하는 기능 (버전을 선택하지 않거나 유효하지 않은 버전이 제공되면 기본 버전이 인계 됨)
2-버전을 추가하려면 POST /mail/send API에 추가 매개 변수가 있어야합니다.

우리는 12 개 이상의 언어와 숫자를 가진 플랫폼을 가지고 있습니다 (예, 우리는 도전을 좋아합니다). 그래서 우리는 다른 언어를위한 특정 마케팅 인력이 필요합니다. 그들은 그렇게 평범한 템플릿을 코딩하지 않습니다. 또한 대규모 사용자를 확보 할 계획이므로 먼저 필요한 템플릿을 활성으로 설정 한 다음 이메일을 보내면 잘못된 템플릿이 선택되는 동시성 문제가 발생합니다.

정말 고마워,

이 문제에 기여한 여러분 안녕하세요!

SendGrid를 사용하여 보낸 이메일을 현지화 / 번역하는 문제를 어떻게 가장 잘 해결할 수 있는지 고객과 함께 조사하고 있습니다. 시간이 좀 남으시면 올바른 구축 방법을 생각할 때 여러분의 피드백을 환영합니다!

다음은 오늘 번역 및 현지화를 처리하는 방법에 대해 저와 제 팀과 대화 할 수있는 슬롯에 등록하는 링크입니다. https://calendly.com/travisterwilligar/sendgrid-research?month=2019-09

시간 내 주셔서 감사합니다!

@ ben-grid는 방금 달력을 확인했지만 시간이 저에게 효과가 없으므로 굉장한 것에 대한 간략한 요약을 제공합니다.

샌드 박스와 프로덕션 계정이있는 전자 상거래 시스템이 있습니다. 그리고 tempalte를 승인하면이를 내보내고 프로덕션으로 가져옵니다 (프로모션 파이프 라인이있는 샌드 박스 및 프로덕션 템플릿이있는 훌륭한 기능이기도합니다).

어쨌든 ... 현재 우리는 2 개의 언어를 가지고 있지만, 당면한 과제는 5 개의 언어로 이동하는 것입니다. 현재 11 개의 템플릿이 있습니다. 지금 우리가하는 일은 {{if lang.en}} 안녕하세요 {{else}} 안녕하세요 {{/ if}}입니다. 이것은 5 개 언어 (가까운 미래에 20 개 언어)에서 작동하지 않을 것이므로 이제 만들 것입니다. 언어 당 별도의 템플릿으로 11 개가 아닌 55 개의 템플릿을 생성합니다. (끔찍함)

무엇이 좋을까요!

옵션 1:
API에 "version"매개 변수를 추가하고 제공된 버전을 전송하십시오. 이제 최소한 서면 언어로 특정 버전을 보낼 수 있습니다 (버전은 템플릿의 번역 된 버전 일 수 있으며 대체 버전은 활성 버전 일 수 있음).

옵션 2
템플릿에 지역화 된 매개 변수를 추가합니다. 이렇게하면 매개 변수 만 번역하여 여러 언어에 대한 템플릿을 사용할 수 있습니다. 이 접근 방식의 단점은 일부 문장 구조가 각 언어에 대해 작동하지 않으므로 더 많은 실행 가능성을 원할 것입니다.

* 옵션 3 황금 눈물의 유니콘 *
기본적으로 각 모듈에 대한 번역 탭이 있습니다. 따라서 이와 같은 모듈을 삽입 할 때
이 모듈에는 여러 로케일이 있습니다. 기본적으로 다른 언어에 대한 원본의 복제본입니다. 템플릿의 언어를 설정할 수 있어야합니다 (모든 모듈을 제목 및 프리 헤더를 포함한 특정 언어로 설정). 해당 모듈에 아직 채워지지 않은 경우 모듈을 빨간색으로 표시 할 수 있습니다.

제 2 센트 만, 이에 대한 귀하의 의견을 환영합니다. 메일을 보내 시려면 [email protected]으로 저에게 연락해주십시오. 감사합니다. 빠른 해결책이 있기를 바랍니다. 그리고 우리가 준비 할 수 있도록 어떻게 대처할 것인지에 대한 통찰력이 없다면

@reneweteling 대단히 감사합니다. 매우 도움이됩니다. 우리는 아마도 1보다 옵션 2와 3에 더 가까운 프로토 타입을 작업하고 있습니다. 피드백을받을 가치가있는 것이 있으면 이메일로 연락 드리겠습니다. 입력 해 주셔서 다시 한 번 감사드립니다!

@reneweteling 저는 옵션 1 또는 2가 작업을 수행 할 것이라고 생각합니다-매우 직관적이기 때문입니다. 옵션 3-글쎄요.

@ ben-grid & @ a-tonchev 모든 노력에 감사드립니다! 이직 한 직업이 나에게는 더 이상 관련이 없습니다. 좋은 일을 계속하십시오!

이것에 대한 소식이 있습니까? 제목 길이 제한은 제목 줄도 현지화해야한다는 점을 감안하면 문제가되는데, 새 에디터를 사용하면 제목 길이가 훨씬 더 작아지고 제목 줄에 110 자 정도를 넣을 수 있다고 생각합니다.

IMO, 더 실행 가능한 솔루션은 모든 텍스트 서버 측을 생성 한 다음 청크 단락으로 템플릿에 삽입하는 것입니다.

회사가 여러 언어를 지원하는 경우 해당 웹 사이트에는 이미 서버 측 (XML / 데이터베이스에서 언어로드)에 대한 솔루션이 있습니다. 제 생각에는 동일한 프로젝트와 관련된 모든 이메일에도 이러한 언어 파일에 텍스트가 저장되어 있어야합니다.

사용자 언어에 따라 필요한 단락 / 텍스트를 해당 파일에서 가져온 다음 템플릿 변수로 sendgrid에 전달할 수 있습니다. 심지어 어떤 스타일 언어 파일 자체에 보관되어야 할 것이다 - Sendgrid 단지 (단지 스타일과 이미지처럼, 바닥 글 등) - 무엇보다 중요한 템플릿 것 같은 등 굵게 특별히하는 단어

따라서 템플릿은 subject HelloLine welcomeparagraph helpparagraph footerslogan 됩니다. 그리고 그게 다야.

IMO, 더 실행 가능한 솔루션은 모든 텍스트 서버 측을 생성 한 다음 청크 단락으로 템플릿에 삽입하는 것입니다.

회사가 여러 언어를 지원하는 경우 해당 웹 사이트에는 이미 서버 측 (XML / 데이터베이스에서 언어로드)에 대한 솔루션이 있습니다. 제 생각에는 동일한 프로젝트와 관련된 모든 이메일에도 이러한 언어 파일에 텍스트가 저장되어 있어야합니다.

사용자 언어에 따라 필요한 단락 / 텍스트를 해당 파일에서 가져온 다음 템플릿 변수로 sendgrid에 전달할 수 있습니다. 심지어 어떤 스타일 언어 파일 자체에 보관되어야 할 것이다 - Sendgrid 단지 (단지 스타일과 이미지처럼, 바닥 글 등) - 무엇보다 중요한 템플릿 것 같은 등 굵게 특별히하는 단어

따라서 템플릿은 subject HelloLine welcomeparagraph helpparagraph footerslogan 됩니다. 그리고 그게 다야.

모든 카피 라이팅 변경에 대해 메일 서비스를 재배포해야하므로 관리가 불가능합니다. 또한 일부 회사에서 메일 내용은 개발자가 아니라 마케팅 / 카피라이터의 책임입니다. 편집을 허용하려면 다른 UI를 재배포해야하지만 우리는 이에 대해 Sendgrid를 지불합니다.

한 프로젝트에서 우리는 각 언어에 대한 이메일 템플릿을 편집하고 생성하기 위해 헤드리스 CMS를 사용합니다. 서버는 런타임에 이러한 콧수염 템플릿을 읽고 Sendgrid로 보낼 이메일 본문을 생성합니다. Sendgrid 템플릿 편집 UX는 완전히 쓸모가 없으므로 우리는 이것을 사용하기로 결정했습니다.

@cecchisandrone 나는 sendgrid가 더 좋을 수 있다는 데 동의합니다. 적절한 언어 관리를 추가하고 매개 변수로 만들어야합니다. 그러나 내가 말했듯이 우리가 그들에게 보내는 일부 변수는 어쨌든 날짜 / 시간 형식과 같이 지역화되어야합니다.

@ corneliu-gavrilovici가 언급했듯이
지금도 가치가 있습니다. 최근 업데이트에서 피사체의 길이가 더 짧아졌습니다. 지금은 2 개 언어 만 사용하고 있으며 제목 필드에서 아래 방식으로 수행했습니다.

{{#if english}}
Hello blah blah...
{{else if french}}
Hello blah blah...
{{/if}}

우리가 사용할 수 있었던 제품이이 문제로 인해 더 이상 사용할 수없는 이유를 알 수 없습니다. 문서에서 다국어 템플릿을 다루는 방법에 대해 말했지만 제대로 사용할 수 없습니다. @ ben-grid
https://sendgrid.com/docs/for-developers/sending-email/using-handlebars/#multiple -languages

IMO, 더 실행 가능한 솔루션은 모든 텍스트 서버 측을 생성 한 다음 청크 단락으로 템플릿에 삽입하는 것입니다.
...
사용자 언어에 따라 필요한 단락 / 텍스트를 해당 파일에서 가져온 다음 템플릿 변수로 sendgrid에 전달할 수 있습니다. 심지어 어떤 스타일 언어 파일 자체에 보관되어야 할 것이다 - Sendgrid 단지 (단지 스타일과 이미지처럼, 바닥 글 등) - 무엇보다 중요한 템플릿 것 같은 등 굵게 특별히하는 단어

따라서 템플릿은 subject HelloLine welcomeparagraph helpparagraph footerslogan 됩니다. 그리고 그게 다야.
서버 측 JS를 사용하여 SalesForce에서이 작업을 수행했습니다. json 객체는 템플릿에 있지만 컴파일 중에 서버에서 실행됩니다. 실제 현지화 기능이있는 것과 유사하며 ecomm 환경에서 사용하는 개발 게시에 의존하지 않습니다.
@ ben-grid가 언급했듯이 SG 팀이 무엇을 생각해 냈는지 기대하고 있습니다.

+1 현지화 기능. 여러 언어가있는 경우 일부 if / else가 엉망입니다.