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

const email = await openemail.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: pdfBytes }],  threadId: 'thread_…',  scheduledAt: 'PT1H',  tags: { order: '4021' },  tracking: { opens: true, clicks: true },})

to, cc и bcc принимают одного получателя или многих, а одиночный оборачивается за вас. Каждый может быть голым адресом, Name <addr@host> или { email, name }.

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

const email = await openemail.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' },}) console.log(email.translation)// { language: 'de', languageName: 'German', detectedSourceLanguage: 'en', subject: true, includeOriginal: true }

Никто это не прочитал перед отправкой. emails.translate — тот же круг, остановленный на шаг раньше. Покажите результат человеку, дайте ему поправить и отправьте одобренное вообще без translate в вызове. Передача его снова перевела бы текст второй раз и выбросила бы их правки.

const preview = await openemail.emails.translate({  subject: 'Your September invoice',  html: '<p>Invoice attached. Payment is due on the 14th.</p>',  to: 'de',}) console.log(preview.language.native, preview.detectedSourceLanguage) const approved = await showToSomebody(preview) await openemail.emails.send({  from: '[email protected]',  to: '[email protected]',  subject: approved.subject,  html: approved.html,})

import { LANGUAGES, isRtlLanguage, languageByCode, openemail, resolveLanguage } from '@openemail/sdk' LANGUAGES.length // 200 const current = await openemail.languages.list() resolveLanguage('Deutsch')?.code // 'de'resolveLanguage('zh-TW')?.code // 'zh-Hant'languageByCode('DE')?.native // 'Deutsch'isRtlLanguage('ar') // true

Таблица входит в пакет, в порядке для списка выбора, так что список можно заполнить ещё до первого запроса. languages.list() разрешается в те же строки с провода, что и обычный массив, — для того, кто предпочитает текущие языки тем, с которыми вышла эта версия. resolveLanguage принимает код, английское название, эндоним или псевдоним (zh-TW — псевдоним кода, которого больше нет в списке), languageByCode сопоставляет точный код без учёта регистра, а шестнадцать строк — справа налево. Ищите по native, label и code вместе, показывайте native первым и храните код.

• —Язык, который ни во что не разрешается, — это validation_error на translate.to, до того как что-либо отправлено.
• —translation_too_long свыше 30 000 символов, translation_not_configured, когда в установке не настроен ИИ, и translation_failed, когда провайдер не ответил. Ни одна из них не отправляет сообщение непереведённым в качестве запасного варианта.
• —Работает с template: переводится ОТРИСОВАННЫЙ результат, так что одно сохранённое тело обслуживает все языки, на которых читают ваши клиенты. Шаблон, отрисовывающий целый документ, сохраняет свой doctype, блоки <style> и правила @font-face: к модели уходит только тело, а остальное возвращается вокруг него. Его <title> остаётся нетронутым — его всё равно нигде не показывают.
• —Повтор не стоит ничего сверху. Перевод не входит в отпечаток идемпотентности (в него входит запрос, включая translate), так что повтор неотвеченной отправки с тем же Idempotency-Key воспроизводит уже существующее сообщение, а не переводит и отправляет второе.
• —Переведённое сообщение в состоянии queued или scheduled заморожено против изменений формулировок. emails.reschedule всё ещё может его перенести; изменить сказанное — значит отменить и отправить заново.

content на проводе в base64. Передайте байты, и они будут закодированы за вас.

attachments: [  { filename: 'invoice.pdf', content: pdfBytes, contentType: 'application/pdf' },]