호스팅 템플릿

수명 주기

템플릿에는 고정된 ID와 키, 편집 가능한 초안 하나, 변경 불가능한 게시 릴리스 0개 이상, 활성 또는 보관 수명 주기가 있습니다. 보관하면 이전 릴리스와 사용 기록은 삭제하지 않고 키 기반의 새 발송만 막습니다.

변수

변수는 키, 타입, 필수 여부, 선택적 기본값으로 선언합니다. 제공된 데이터가 게시된 계약을 충족하지 않으면 렌더링이 422로 실패합니다. 삽입되는 값은 컨텍스트에 맞게 이스케이프됩니다.

낙관적 자동 저장

각 초안에는 리비전이 있습니다. 현재 리비전을 PUT /templates/:id/draft에 보내세요. 다른 편집자가 먼저 저장했다면 SendHQ가 409를 반환하므로, 덮어쓰기 전에 다시 불러오세요.

미리 보기, 테스트, 게시

1. 대표적인 샘플 데이터로 렌더링합니다.
2. 모든 오류 항목을 해결합니다.
3. 직접 관리하는 주소로 테스트 스냅샷을 발송합니다.
4. 해당 초안을 그대로 변경 불가능한 릴리스로 게시합니다.

키로 발송

{
  "from": "hello@example.com",
  "to": [
    "customer@example.net"
  ],
  "template": {
    "key": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

개인화된 템플릿 발송에는 To 수신자가 정확히 한 명이어야 하며 Cc나 Bcc는 사용할 수 없습니다. 개별화된 수신자에게는 일괄 발송 엔드포인트를 사용하세요.

출처 기록

모든 템플릿 발송은 템플릿, 릴리스, 컴파일러 버전, 렌더링된 콘텐츠 해시를 기록하므로, 과거 메시지를 그것을 만들어 낸 콘텐츠까지 추적할 수 있습니다.