List Customer Emails
고객에게 발송된 이메일과 전송 결과를 확인합니다.
Get Email Content
보낸 그대로 이메일 하나를 확인합니다.
개요
Dodo Payments는 회원님을 대신하여 고객에게 transactional email을 보냅니다. 여기에는 영수증, 환불 알림, 구독 알림, 미납 결제 및 복구 이메일, entitlement 부여, Customer Portal 로그인 링크가 포함됩니다. 고객의 Sent Emails 탭에는 각 이메일이 하나씩 기록됩니다. 각 이메일에 대해 어떤 내용이 전송되었는지, 어디까지 전달되었는지, 실패한 경우 왜 도착하지 않았는지를 확인할 수 있습니다. 고객이 받은 이메일을 열어 보고 다시 전송할 수도 있습니다.
이메일은 180일 동안 보관됩니다. Delivery status는 이메일 provider에서 제공하며, 일반적으로 각 delivery event 발생 후 몇 초 이내에 업데이트됩니다.
고객의 이메일 확인
1
Open the Customer
대시보드에서 Sales → Customers로 이동한 다음 고객을 선택합니다.
2
Open the Sent Emails Tab
이 탭에는 최근 180일 동안 이 고객에게 전송된 모든 이메일이 최신순으로 표시됩니다.
3
Read a Row
각 행에는 제목이 표시되고, 그 아래에 sender와 recipient address가 표시됩니다. 다른 열에는 Category, Date & Time, Delivery Status, 그리고 수행할 수 있는 Actions가 표시됩니다.
Delivery Status
각 이메일에는 5가지 상태 중 하나가 지정됩니다. API는 status value를 반환하고, 대시보드에는 해당 label이 표시됩니다:Failure Reasons
이메일이 도착하지 않으면 해당 행에 이유가 표시되므로 조치가 필요한지 알 수 있습니다. 행의 status에 포인터를 올리면 이유를 확인할 수 있습니다. API는failure_reason에 동일한 이유를, failure_code에 변경되지 않는 code를 반환합니다:
이유 중 5가지의 경우에는 같은 address로 다시 전송하면 다시 실패하므로 resend 시 다른 address가 필요합니다. 해당 이유는 mailbox does not exist, address rejected, address blocked after earlier failures, message rejected as too large, recipient marked the email as spam입니다.
이메일 읽기
이메일을 읽으려면 해당 행에서 Resend를 선택하거나, 실패한 행에서 Retry를 선택합니다. 열리는 panel의 Email Preview 아래에는 전송된 그대로 저장된 사본이 표시됩니다. 직접 작성한 recovery 및 dunning 이메일에는 Written by you label이 표시됩니다.
- Customer Portal 로그인 이메일. 실시간 login link가 포함되므로 콘텐츠가 표시되지 않습니다.
- 차단된 이메일. provider에 도달하지 않았으므로 사본이 없습니다.
- provider에 전달할 수 없었던 이메일. 사본이 저장되지 않았습니다.
- 180일이 지난 이메일. 해당 시점에 provider가 콘텐츠를 삭제합니다.
이메일 다시 전송하기
이메일을 다시 전송하려면 해당 행에서 Resend를 선택하거나, 실패한 행에서 Retry를 선택한 다음 panel에서 확인합니다. 버튼에는 해당 이메일을 다시 전송할 수 있는 횟수가 표시됩니다. Dodo Payments는 저장된 사본이 아니라 original event에서 이메일을 다시 생성하므로, receipt에는 payment의 current state가 표시됩니다. 이메일에는 original event의 date가 유지됩니다.
제한
다음 제한은 모든 resend에 적용됩니다:- 각 이메일은 3회까지 다시 전송할 수 있습니다.
- 하나의 이메일을 같은 address로 resend할 때는 시도 사이에 대기 시간이 있습니다. 첫 번째 resend 전에는 latest send 후 5분, 두 번째 전에는 10분, 세 번째 전에는 15분을 기다려야 합니다.
- 어떤 address로든 resend하려면 해당 address가 마지막으로 귀하에게서 이메일을 받은 후 5분이 지나야 합니다.
- provider에 도달하지 않은 send는 3회 제한에 포함되지 않습니다. 하지만 대기 시간에는 반영됩니다.
- Resend는 대시보드에서만 사용할 수 있습니다. API는 read-only입니다.
Resend를 사용할 수 없는 경우
다음과 같은 경우 대시보드에 resend 옵션이 표시되지 않거나 resend가 거부됩니다:Customer Portal 로그인 이메일은 항상 요청한 address로 전송되며, 각 resend는 새로운 login link를 생성합니다.
Test Mode
테스트 모드에서는 실제 이메일이 전송되므로 비즈니스당 주 100개 이메일의 allowance가 적용됩니다. 재전송도 동일한 allowance에서 차감됩니다. 각 테스트 모드 이메일은 실제 수신자에게 전송되며, 제목 시작 부분에[TEST MODE]가 포함됩니다.
테스트 모드 고객 이메일을 중지하려면 Settings → Communication → Email에서 Test Mode Emails를 끄세요(Test Mode Emails 참조). 이 기능이 꺼져 있는 동안에는 테스트 모드에서 고객 이메일이 전송되지 않고, 탭에 행이 추가되지 않으며, allowance가 차감되지 않고, 대시보드에서 재전송이 거부됩니다. Live mode 이메일에는 영향을 주지 않습니다.
allowance를 모두 사용하면 해당 주에는 테스트 모드에서 더 이상 아무것도 전송되지 않습니다. 해당 주에 처음으로 거부된 이메일은 하나의 blocked 행으로 기록되며, “Not sent: the test-mode email allowance for this week is spent”라는 내용이 표시됩니다. 같은 주에 이후 거부된 이메일은 행을 추가하지 않습니다. allowance는 매주 월요일, 주가 시작될 때 재설정됩니다. Live mode에는 이러한 제한이 없습니다.
Customer Portal 로그인 이메일은 테스트 모드에서 전송되지 않으며 allowance도 차감하지 않습니다.
API를 통한 이메일 읽기
목록과 콘텐츠는 API key로도 사용할 수 있으므로, 자체 support tool에서 전송 상태를 표시할 수 있습니다. 목록은 기본적으로 페이지당 이메일 10개를 반환합니다. 최대 100개를 반환하려면page_size를 설정하고, 0부터 시작해 페이지를 탐색하려면 page_number를 설정하세요.
client.customers.emails.list() 및 client.customers.emails.retrieveBody()로 래핑합니다(Python에서는 retrieve_body()).
각 항목에는 email_log_id가 포함되어 있으며, 이를 content endpoint에 전달해야 합니다. 또한 status도 포함됩니다. 전송에 실패한 경우에는 failure_code 및 failure_reason도 포함되며, 저장된 콘텐츠가 존재하는지를 나타내는 has_preview도 포함됩니다. 이메일에 표시할 콘텐츠가 없으면 content endpoint가 422를 반환합니다. 각 항목에는 행에 대해 수행할 수 있는 작업을 나타내는 policies 객체도 포함됩니다.
직접 자격을 계산하지 말고
policies를 확인하세요. 서버가 위의 규칙을 적용합니다.
Customer Management
고객, 구매 내역 및 self-service access를 관리합니다.
Communication Preferences
Dodo Payments가 귀하를 대신하여 전송하는 이메일을 선택합니다.