Eine E-Mail senden

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 und bcc nehmen einen oder mehrere Empfänger entgegen, und ein einzelner wird für Sie verpackt. Jeder darf eine blanke Adresse, Name <addr@host> oder { email, name } sein.

translate verfasst die Nachricht vor dem Versand in der Sprache eines anderen. Der Body und, sofern Sie das nicht abschalten, der Betreff werden übersetzt, sobald die API die Anfrage annimmt, und was dabei herauskam, geht hinaus: Eine Übersetzung, die nicht erzeugt werden konnte, lässt den Versand scheitern, statt die Nachricht in der Sprache zu verschicken, in der Sie sie geschrieben haben.

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 }

Niemand hat das gelesen, bevor es hinausging. emails.translate ist derselbe Weg, einen Schritt früher angehalten. Zeigen Sie das Ergebnis einer Person, lassen Sie sie es ändern und senden Sie dann das Freigegebene ganz ohne translate am Aufruf. Es erneut zu übergeben würde ein zweites Mal übersetzen und ihre Änderungen verwerfen.

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

Die Tabelle ist mitgeliefert, in der Reihenfolge des Auswahlfelds, ein Auswahlfeld lässt sich daher schon vor der ersten Anfrage füllen. languages.list() löst als einfaches array zu denselben Zeilen von der Leitung auf, für Aufrufer, denen die aktuellen lieber sind als die, mit denen diese Version ausgeliefert wurde. resolveLanguage nimmt einen Code, einen englischen Namen, ein Endonym oder einen Alias entgegen (zh-TW ist ein Alias eines nicht mehr gelisteten Codes), languageByCode trifft einen exakten Code ohne Beachtung der Groß- und Kleinschreibung, und sechzehn der Zeilen laufen von rechts nach links. Durchsuchen Sie native, label und code gemeinsam, zeigen Sie native zuerst und speichern Sie den Code.

• —Eine Sprache, die auf nichts auflöst, ergibt einen validation_error auf translate.to, bevor irgendetwas gesendet wird.
• —translation_too_long bei über 30.000 Zeichen, translation_not_configured, wenn für die Installation keine KI konfiguriert ist, translation_failed, wenn der Anbieter nicht geantwortet hat. Keiner dieser Fälle sendet die Nachricht ersatzweise unübersetzt.
• —Funktioniert mit template: Übersetzt wird die GERENDERTE Ausgabe, ein gespeicherter Body bedient daher jede Sprache, in der Ihre Kunden lesen. Ein Template, das ein ganzes Dokument rendert, behält seinen doctype, seine <style>-Blöcke und seine @font-face-Regeln: Nur der Body geht an das Modell, der Rest wird wieder darum gelegt. Sein <title> bleibt unangetastet, was ohnehin nirgends angezeigt wird.
• —Eine Wiederholung kostet nichts zusätzlich. Die Übersetzung ist nicht Teil des Idempotenz-Fingerabdrucks (die Anfrage schon, translate eingeschlossen), eine Wiederholung eines unbeantworteten Versands mit demselben Idempotency-Key spielt daher die bereits existierende Nachricht erneut ab, statt ein zweites Mal zu übersetzen und zu senden.
• —Eine übersetzte Nachricht, die queued oder scheduled ist, ist gegen Änderungen am Wortlaut eingefroren. emails.reschedule verschiebt sie weiterhin; ihren Inhalt zu ändern bedeutet abbrechen und erneut senden.

content ist auf der Leitung base64. Übergeben Sie Bytes, dann werden sie für Sie kodiert.

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