보낸 메일과 예약 메일
이미 나갔거나 나갈 차례를 기다리는 메일.
보낸 메일과 예약 메일 도구
| 도구 | 하는 일 |
|---|---|
| listSentEmails | 워크스페이스가 보냈거나 보낼 메일을 최신순으로 보여 주며, status, 발신자, 브로드캐스트, 또는 scheduledFrom과 scheduledTo 기간으로 거를 수 있습니다. |
| getSentEmail | 보냈거나 예약된 이메일 한 통: 상태, 나갈 예정 시각이나 나간 시각, 무엇이 잘못되었는지, 수신자마다 어떤 상태인지. |
| listEmailEvents | 이메일 한 통에 일어난 일, 오래된 순: 발송, 실패, 예약 변경, 그리고 추적되는 경우 모든 열람, 클릭, 다운로드. |
| rescheduleEmail | 아직 나가지 않은 이메일을 새 시각, 즉 ISO 8601 시각이나 PT2H 같은 기간 뒤로 옮깁니다. |
| updateScheduledEmail | 아직 나가지 않은 이메일의 제목, 본문, 발신자, 수신자를 바꿉니다. |
| cancelEmail | 아직 나가지 않은 이메일을 멈춥니다. 되살릴 수 없고, 다시 보낼 수만 있습니다. |
읽기에는 “보낸 메시지와 전달 상태 읽기”(emails:read), 발송 시각 옮기기, 변경, 취소에는 “메일 보내기”(emails:send)가 필요합니다. 일부 주소로 제한된 클라이언트는 그 주소에서 보낸 메일에만 닿으며, 역할이 모든 주소에 미치지 않는 사람은 자신이 보낸 메일만 옮기거나 바꾸거나 취소할 수 있습니다.
접수될 때 번역된 메시지는 문구가 그대로 유지되고, 암호화된 메시지는 문구와 수신자가 그대로 유지되므로 updateScheduledEmail은 이를 바꾸는 요청을 거부합니다. 대신 취소하고 다시 보내세요.
앱의 채팅에서 cancelEmail은 항상 먼저 묻고, 이메일의 발송 시각을 옮기거나 내용을 바꾸는 작업은 직접 요청하지 않았다면 묻습니다.
레퍼런스
listSentEmails
Mail this workspace has sent or will send, newest first: messages sent through the app, the API and automations, with their status. status keeps some statuses: queued and scheduled are still waiting, sending, sent, partial, failed and cancelled are not. scheduledFrom and scheduledTo, ISO 8601 instants, keep the messages scheduled inside that window, which with status scheduled and queued is what is waiting to go out. When more follow, the last line gives a cursor.
입력
statusstring[]- 다음 중 하나
"queued""scheduled""sending""sent""partial""cancelled""failed" fromstringscheduledFromstring- 형식
date-time scheduledTostring- 형식
date-time broadcastIdstringlimitinteger- 1 이상100 이하
cursorstring
다른 사용처
getSentEmail
One sent or scheduled email by id: its status, when it is due or went out, what went wrong if anything did, and where it stands with each recipient. Take the id from listSentEmails or from what sendEmail returned.
입력
idstring필수- 비어 있지 않음
다른 사용처
listEmailEvents
What happened to one sent email, oldest first: accepted, queued, scheduled, sent, failed, cancelled, rescheduled and, when it was tracked, every counted open, click and download. When more follow, the last line gives a cursor.
입력
idstring필수- 비어 있지 않음
limitinteger- 1 이상100 이하
cursorstring
다른 사용처
rescheduleEmail
Move a scheduled or queued email to a new time. scheduledAt is an ISO 8601 instant or a duration such as PT2H, in the future and at most a year out. getCurrentDate gives the time now.
입력
idstring필수- 비어 있지 않음
scheduledAtstring필수- 비어 있지 않음
다른 사용처
updateScheduledEmail
Change an email that has not gone yet: its subject, its body as html or text, the address it goes out as, or who it goes to. A recipient list replaces the stored one whole. A field you leave out keeps its value. A message translated when it was accepted keeps its wording, and one that was encrypted keeps its wording and its recipients, so cancel it and send again instead.
입력
idstring필수- 비어 있지 않음
subjectstring- 최대 998자
htmlstring- 최대 1000000자
textstring- 최대 1000000자
fromstringtoobject[]- 1~50개 항목
emailstring필수- 최대 320자형식
email namestring- 최대 128자
ccobject[]- 최대 50개 항목
emailstring필수- 최대 320자형식
email namestring- 최대 128자
bccobject[]- 최대 50개 항목
emailstring필수- 최대 320자형식
email namestring- 최대 128자
다른 사용처
cancelEmail
Stop an email that has not gone yet: a scheduled one, or one still inside its undo window. It cannot be brought back afterwards, only sent again. One that has already gone cannot be cancelled. Cancelling twice is not an error.
입력
idstring필수- 비어 있지 않음