Отправка письма

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> или Hash с email и name.

Сообщение передаётся именованными аргументами или одним Hash. Именованные аргументы рядом с Hash сливаются с ним и имеют приоритет, если оба задают одно поле, поэтому client.emails.send(message, subject: "Re: your invoice") меняет одно поле в сообщении, собранном ранее. Ключи сохраняют имена из API, поэтому replyTo и scheduledAt остаются в camelCase, тогда как idempotency_key: и api_key: являются параметрами вызова и никогда не входят в сообщение.

Hash с ключами типа Symbol, поэтому email[:status] читает статус.

translate пишет сообщение на чужом языке перед его уходом. Тело, а также тема, если вы это не отключите, переводятся в момент приёма запроса, и что получилось, то и уходит: перевод, который не удалось получить, отклоняет отправку, а не отправляет письмо на том языке, на котором вы его написали.

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, замороженный Array из Hash с code, label, native, flag и rtl, поэтому список выбора можно заполнить до первого запроса. languages.list возвращает те же строки по сети как обычный Array для тех, кому нужны текущие строки, а не те, с которыми вышла эта версия. OpenEmail.resolve_language принимает код, английское название, самоназвание или псевдоним (zh-TW является псевдонимом кода, которого больше нет в списке) и возвращает nil, если ничего не совпало, OpenEmail.language_by_code ищет точное совпадение кода без учёта регистра, а шестнадцать строк пишутся справа налево. Ищите по native, label и code вместе, показывайте сначала native и сохраняйте код.

• —Язык, который API не может распознать, даёт validation_error для translate.to ещё до отправки.
• —translation_too_long при объёме свыше 30 000 символов, translation_not_configured, когда в установке не настроен ИИ, 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. Передайте байты, и они будут закодированы за вас: двоичную String, например ту, что возвращает File.binread, IO, например открытый File, или 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:)