이메일 보내기

email = client.emails.send(  from: {email: "[email protected]", name: "Acme Billing"},  to: ["[email protected]", "Grace <[email protected]>"],  cc: "[email protected]",  bcc: [{email: "[email protected]"}],  replyTo: "[email protected]",  subject: "Your September invoice",  html: "<p>Invoice attached.</p>",  text: "Invoice attached.",  headers: {"X-Campaign" => "invoices"},  attachments: [{filename: "invoice.pdf", content: Pathname("invoice.pdf")}],  threadId: "CAHk7pQ2x9LmZ4-mail.example.com",  scheduledAt: "PT1H",  tags: {order: "4021"},  tracking: {opens: true, clicks: true}) puts email[:id], email[:status]

to, cc, bcc는 수신자 하나 또는 수신자의 Array를 받으며, 하나만 주면 자동으로 감싸 줍니다. 각각은 주소만 쓰거나 Name <addr@host>, 또는 email과 name을 가진 Hash일 수 있습니다.

메시지는 키워드 인자나 Hash 하나로 전달합니다. Hash와 나란히 준 키워드 인자는 그 Hash에 병합되며 같은 필드를 지정하면 키워드 인자가 우선하므로, client.emails.send(message, subject: "Re: your invoice")는 앞서 만든 메시지의 필드 하나만 바꿉니다. 키는 API의 이름을 그대로 쓰므로 replyTo와 scheduledAt은 camelCase로 남지만, idempotency_key:와 api_key:는 호출의 옵션이며 메시지의 일부가 아닙니다.

Symbol 키를 가진 Hash이므로, email[:status]로 상태를 읽습니다.

translate는 메시지가 나가기 전에 다른 사람의 언어로 다시 씁니다. 본문과, 끄지 않았다면 제목까지 API가 요청을 수락할 때 번역되고, 번역된 결과가 그대로 나갑니다. 번역을 만들어 내지 못하면 원래 쓴 언어로 보내는 대신 발송을 거부합니다.

email = client.emails.send(  from: "[email protected]",  to: "[email protected]",  subject: "Your September invoice",  html: "<p>Invoice attached. Payment is due on the 14th.</p>",  translate: {to: "de"}) p email[:translation]

그러면 email[:translation]은 {language: "de", languageName: "German", detectedSourceLanguage: "en", subject: true, includeOriginal: true}가 됩니다.

그렇게 나간 메일은 아무도 검토하지 않은 것입니다. emails.translate는 같은 왕복을 한 단계 앞에서 멈춘 것입니다. 사람에게 보여 주고 고치게 한 다음, 승인된 내용을 호출에 translate 없이 그대로 보내세요. 다시 전달하면 두 번 번역되어 그 수정이 버려집니다.

preview = client.emails.translate(  subject: "Your September invoice",  html: "<p>Invoice attached. Payment is due on the 14th.</p>",  to: "de") puts preview.dig(:language, :native), preview[:subject], preview[:html]print "Send it as it is? [y/N] " if $stdin.gets.to_s.strip.casecmp?("y")  client.emails.send(    from: "[email protected]",    to: "[email protected]",    subject: preview[:subject],    html: preview[:html]  )end

p OpenEmail::LANGUAGES.size current = client.languages.listp current.size p OpenEmail.resolve_language("Deutsch")&.fetch(:code)p OpenEmail.resolve_language("zh-TW")&.fetch(:code)p OpenEmail.language_by_code("DE")&.fetch(:native)p OpenEmail.rtl_language?("ar")

이 줄들은 이 버전에 포함된 행의 수인 200, API가 지금 가진 행의 수, 그리고 "de", "zh-Hant", "Deutsch", true를 출력합니다. 이 표는 선택기 순서 그대로 OpenEmail::LANGUAGES로 번들에 포함되어 있으며, code, label, native, flag, rtl을 가진 Hash의 동결된 Array이므로 첫 요청 전에 선택기를 채울 수 있습니다. languages.list는 이 버전에 포함된 것이 아니라 현재 목록을 원하는 호출자를 위해, 같은 행을 통신으로 받아 일반 Array로 반환합니다. OpenEmail.resolve_language는 코드, 영어 이름, 자칭 이름, 별칭(zh-TW는 더 이상 목록에 없는 코드의 별칭입니다)을 받고 일치하는 것이 없으면 nil을 반환하며, OpenEmail.language_by_code는 대소문자를 무시하고 코드를 정확히 일치시킵니다. 행 중 16개는 오른쪽에서 왼쪽으로 씁니다. native, label, code를 함께 검색하고, native를 먼저 보여 주고, 코드를 저장하세요.

• —API가 일치시킬 수 없는 언어는 무엇이든 보내기 전에 translate.to에 대한 validation_error가 됩니다.
• —30,000자를 넘으면 translation_too_long, 설치본에 AI가 구성되어 있지 않으면 translation_not_configured, 워크스페이스가 오늘의 AI 작업을 다 썼으면 429 ai_quota_exceeded(UTC 자정에 초기화되며 재시도하지 않습니다), 제공자가 응답하지 않으면 translation_failed입니다. 어느 것도 번역되지 않은 메시지를 대신 보내지 않습니다.
• —template과 함께 동작합니다. 번역되는 것은 렌더링된 결과이므로, 저장된 본문 하나가 고객이 읽는 모든 언어를 감당합니다. 문서 전체를 렌더링하는 템플릿은 doctype과 <style> 블록, @font-face 규칙을 그대로 유지합니다. 모델에 가는 것은 본문뿐이고 나머지는 다시 그 주위에 붙습니다. <title>은 그대로 두는데, 어차피 표시하는 곳이 없습니다.
• —재시도에 추가 비용은 없습니다. 번역은 멱등성 지문의 일부가 아니므로(지문에 들어가는 것은 translate를 포함한 요청입니다), 응답이 없던 발송을 같은 Idempotency-Key로 재시도하면 두 번째로 번역해 보내는 대신 이미 존재하는 메시지를 재생합니다.
• —큐에 있거나 예약된 번역 메시지는 승인된 문구를 유지합니다. emails.reschedule로 시각은 옮길 수 있지만, emails.update는 새 문구를 409 translation_locked로 거부하므로, 내용을 바꾸려면 취소하고 다시 보내야 합니다.

content는 통신상에서 base64입니다. 바이트를 전달하면 자동으로 인코딩됩니다: File.binread가 반환하는 것 같은 바이너리 String, 열린 File 같은 IO, 또는 대신 읽어 주는 Pathname입니다.

attachments = [  {filename: "invoice.pdf", content: File.binread("invoice.pdf"), contentType: "application/pdf"},  {filename: "report.pdf", content: Pathname("report.pdf")},  {fileId: "file_6bb640f5b99e47deb758f1f5"}] client.emails.send(  from: "[email protected]",  to: "[email protected]",  subject: "Your documents",  text: "Both are attached.",  attachments:)