부재중 자동응답 설정
한 주소나 catch-all의 응답을 저장하며, 이미 저장된 것은 대체합니다.
워크스페이스에 실제 호출을 실행합니다.
PUT /out-of-office
한 주소나 catch-all의 응답을 저장하며, 이미 저장된 것은 대체합니다.
예시
settings:write가 필요합니다. address는 쿼리에 넣고, 필수 필드는 message 하나뿐입니다. 1자에서 10,000자 사이의 일반 텍스트입니다.
curl -X PUT "$OE/[email protected]" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "startsAt": "2026-12-22T00:00:00Z", "endsAt": "2027-01-04T08:00:00Z", "subject": "Away until 4 January", "message": "I am away until 4 January and will answer when I am back." }'{ "object": "out_of_office", "address": "[email protected]", "enabled": true, "active": true, "startsAt": "2026-12-22T00:00:00.000Z", "endsAt": "2027-01-04T08:00:00.000Z", "subject": "Away until 4 January", "message": "I am away until 4 January and will answer when I am back.", "contactsOnly": false, "updatedAt": "2026-12-22T09:14:03.117Z"}지금 시작하거나 이미 켜져 있는 응답의 시작을 유지하려면 startsAt을 생략하고, 끌 때까지 응답을 유지하려면 endsAt을 생략하거나 null로 두세요. subject는 최대 255자이며, 비워 두면 Re:와 받은 제목으로 답합니다. enabled: false는 텍스트를 유지한 채 응답을 일시 중지하고, contactsOnly: true는 연락처와 워크스페이스가 메일을 쓴 적이 있는 사람에게만 답합니다.
발신자마다 부재 기간 전체에 걸쳐 응답을 한 번 받으며, 같은 스레드 안에서, 메일이 도착한 주소로부터 받습니다. startsAt을 바꾸면 모두에게 한 번 더 답하는 새 기간이 시작되고, 텍스트나 endsAt만 바꾸면 그렇지 않습니다. endsAt이 없으면 30일 뒤에 같은 발신자에게 다시 답합니다. 응답에는 Auto-Submitted: auto-replied가 붙고, 추적과 서명은 없으며, 월간 발송 수에 포함되고, 음소거된 스레드에서도 나갑니다.
누구에게도 알림이 가지 않을 메일에는 응답하지 않습니다. 스팸, 규칙이 휴지통으로 옮긴 메일, 뉴스레터와 그 밖의 대량 메일, 자동 메일, 반송 메일, 차단한 발신자, 워크스페이스 자체의 주소가 그렇습니다. 정확히 그 주소에 저장된 응답이 먼저 적용되고, 다음으로 플러스 태그를 뺀 주소의 응답, 그다음으로 catch-all의 응답이 적용되며, catch-all은 누군가 직접 만든 주소를 대신해 답하는 일이 없습니다.
422 invalid_parameter는 address가 없거나, 워크스페이스의 주소가 아니거나, 도메인 전체를 가리키는 경우, 메시지가 비어 있는 경우, 또는 endsAt이 startsAt보다 뒤가 아니거나 이미 지난 경우를 뜻합니다. 타이머로 도는 것은 없으며, 날짜는 메일이 도착할 때 확인됩니다.