Send API로 보내는 인터랙티브 트랜잭션 이메일

영수증과 확인 메일은 고객이 가장 많이 여는 이메일입니다. 스튜디오에서 한 번 디자인하고 Send API로 백엔드에서 보내면, 모든 영수증이 주문이 어땠는지 묻고 다음 상품을 제안할 수 있습니다.

제목

Your order receipt

영수증과 확인 메일은 고객이 가장 많이 여는 이메일입니다. 캠페인과 같은 인터랙티브 블록으로 Send API를 통해 백엔드에서 보내면, 모든 영수증이 주문이 어땠는지 묻고 다음 상품을 제안할 수 있습니다.

영수증은 구매 직후 거의 모든 고객에게 갑니다. 그래서 빠른 평점, 리필, 다음 주문용 코드를 담기에 가장 좋은 자리입니다. 평범한 영수증만큼 쉽게 보낼 수 있다면요.

한 번 디자인하고 백엔드에서 보내기

스튜디오에서 일반 이메일로 영수증을 만들고, {{order_number}} 같은 병합 태그와 원하는 블록을 넣으세요.

  • 평점: "주문은 어떠셨나요?"를 별이나 이모지 얼굴로. 평점이 이 값 이하이면 추가 질문을 쓰면 낮은 점수에 무엇이 문제였는지 묻는 짧은 질문이 열립니다.
  • 상품: 관련 상품이나 리필을 영수증에서 지금 구매로 삽니다.
  • 쿠폰: 다음 주문용 코드를 탭 한 번으로 복사.
  • 버튼: 주문 상태, 청구서, 고객 지원.

그다음 백엔드가 이메일의 projectId와 그 주문의 값을 담은 mergeData 객체(최대 100개 필드)로 POST /api/v1/send를 호출합니다. API 레퍼런스의 템플릿을 참고하세요.

어떤 앱으로 읽든, 모든 고객이 영수증에서 평가하고, 구매하고, 클릭할 수 있습니다.

연락처와 연결

고객이 이미 연락처라면 영수증이 그 사람과 연결됩니다. listId를 넘기거나, MailInApp이 목록에서 주소를 찾게 하세요. 그러면 평점이 그 사람의 활동과 참여 점수에 기록되고, 연락처 필드를 채우거나 여정을 시작할 수 있으며, 회의 예약은 클릭 한 번으로 끝납니다. API 레퍼런스를 참고하세요.

운영 환경을 위한 기능

  • type: "transactional"(기본값)은 마케팅 수신을 거부한 고객에게도 갑니다. 영수증은 여전히 필요하기 때문입니다. 반송된 주소는 건너뜁니다. 트랜잭션 vs 마케팅을 참고하세요.
  • Idempotency-Key: 같은 키로 다시 시도한 호출은 첫 결과를 돌려주므로, 고객은 영수증을 한 통만 받습니다. 멱등성을 참고하세요.
  • 한도: API 키마다 분당 한도가 있고, 요금제에 월간 Send API 호출 수가 포함됩니다. 최근 호출은 개발자 페이지에 표시됩니다.
  • 코드 없이: Zapier의 Send Transactional Email 액션과 n8n 노드도 같은 방식으로 보냅니다.
  • 일회용 코드: projectId 대신 html이나 text를 보내면 그대로 발송됩니다.

돌아오는 것

평점, 클릭, 구매는 다른 캠페인처럼 이메일의 인사이트에 나타나고, 웹훅이 도착하는 대로 하나씩 시스템에 전달합니다. 저점수 알림이 고객이 주문에 낮은 점수를 주면 알려 주므로, 그날 바로 연락할 수 있습니다.

시작하기

스튜디오에서 평점이 든 영수증을 만들고, 개발자 메뉴에서 API 키를 만든 뒤, projectId와 mergeData로 POST /api/v1/send를 호출하세요. 첫 호출은 빠른 시작에서 차례로 안내합니다.

일반적인 제작 및 발송 순서

  1. 1

    스튜디오에서 영수증 디자인하기

    평점, 상품 또는 쿠폰과 {{order_number}} 같은 병합 태그를 넣어 일반 이메일로 만듭니다.

  2. 2

    API 키 만들기

    개발자 메뉴에서 이름 있는 API 키를 만듭니다. 각 호출은 이를 Bearer 토큰으로 보냅니다.

  3. 3

    Send API 호출하기

    백엔드가 이메일의 projectId와 그 주문의 값을 담은 mergeData 객체로 /api/v1/send에 POST합니다.

  4. 4

    돌아오는 정보 보기

    평점, 클릭, 구매가 이메일의 인사이트에 나타나고, 웹훅이 도착하는 대로 하나씩 전달합니다.

자주 묻는 질문

API로 보내는 이메일에도 캠페인과 같은 인터랙티브 블록을 넣을 수 있나요?

네. 템플릿 모드는 지정한 스튜디오 이메일을 모든 블록과 함께, 대시보드에서 보낼 때와 똑같이 만듭니다.

주문 데이터는 어떻게 이메일에 들어가나요?

mergeData로 들어갑니다. 최대 100개 필드의 평평한 객체로, 그 호출에 한해 이메일의 {{field}} 병합 태그를 채웁니다. listId도 넘기면, 고객이 이미 연락처일 때 이메일이 그 사람과 연결되어 평점이 그 사람의 활동에 기록됩니다.

transactional과 marketing은 무엇이 다른가요?

type 필드가 어떤 수신 차단 목록을 확인할지 정합니다. 기본값인 transactional은 마케팅 수신을 거부한 고객에게도 갑니다. 영수증은 여전히 필요하기 때문입니다. marketing은 캠페인처럼 동작합니다. 둘 다 반송된 주소는 건너뜁니다.

Send API에는 어떤 한도가 있나요?

API 키마다 분당 한도가 있고, 요금제에 월간 Send API 호출 수(Free는 500)가 포함되며, 모든 발송은 요금제의 월간 이메일 수에 포함됩니다. Idempotency-Key 헤더를 쓰면 다시 시도한 호출이 첫 결과를 돌려주므로, 고객은 영수증을 한 통만 받습니다.

같은 엔드포인트로 직접 만든 HTML을 보낼 수 있나요?

네. projectId 대신 html이나 text를 보내면 그대로 발송됩니다. 일회용 코드에 알맞고, 인터랙티브 블록에는 템플릿 모드를 씁니다.

스튜디오에서 만들어보세요

무료 플랜으로 시작하세요 — 모든 인터랙티브 블록과 전체 폴백 엔진이 모든 플랜에 포함됩니다.