E-mail küldése

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 },})

A to, a cc és a bcc egy vagy több címzettet fogad, és az egyedülállót helyetted tömbbe csomagoljuk. Mindegyik lehet csupasz cím, Name <addr@host> vagy { email, name }.

A translate még kimenet előtt átírja az üzenetet valaki más nyelvére. A törzset – és a tárgyat is, hacsak azt ki nem kapcsolod – akkor fordítjuk le, amikor az API elfogadja a kérést, és ami kijött, az megy ki: ha a fordítást nem sikerült előállítani, elutasítjuk a küldést, nem pedig azon a nyelven adjuk fel, amelyen írtad.

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 }

Azt senki nem olvasta el, mielőtt elment. Az emails.translate ugyanaz a körfordulat, egy lépéssel korábban megállítva. Mutasd meg egy embernek, engedd, hogy módosítson rajta, majd küldd el, amit jóváhagyott – translate nélkül a híváson. Ha újra megadnád, másodszor is lefordítaná, és eldobná a szerkesztéseit.

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

A táblázat a csomag része, választósorrendben, így egy választó már az első kérés előtt feltölthető. A languages.list() ugyanezekkel a sorokkal tér vissza a hálózatról, sima tömbként, annak, aki inkább az aktuálisakat szeretné, mint azokat, amelyekkel ez a verzió megjelent. A resolveLanguage kódot, angol nevet, endonimát vagy aliast fogad (a zh-TW egy már nem listázott kód aliasa), a languageByCode kis- és nagybetűtől függetlenül pontos kódra illeszt, és a sorok közül tizenhat jobbról balra író. A native, a label és a code mezőben együtt keress, a native értéket mutasd elöl, és a kódot tárold.

• —Az a nyelv, amely semmire nem oldódik fel, validation_error a translate.to mezőn, még mielőtt bármi elmenne.
• —translation_too_long 30 000 karakter felett, translation_not_configured, ha a telepítésen nincs AI beállítva, translation_failed, ha a szolgáltató nem válaszolt. Egyik sem küldi el tartalékként az üzenetet lefordítatlanul.
• —Működik a template mezővel: a RENDERELT kimenetet fordítjuk le, így egy tárolt törzs minden nyelvet kiszolgál, amelyen az ügyfeleid olvasnak. A teljes dokumentumot rendelő sablon megtartja a doctype-ját, a <style> blokkjait és az @font-face szabályait: csak a törzs megy a modellhez, a többit köré tesszük vissza. A <title> elemet érintetlenül hagyjuk, amit amúgy sem jelenít meg semmi.
• —Az újrapróbálkozás nem kerül semmi többe. A fordítás nem része az idempotencia-ujjlenyomatnak (a kérés igen, a translate mezővel együtt), így ha ugyanazzal az Idempotency-Key értékkel próbálsz újra egy megválaszolatlan küldést, a már létező üzenetet játsszuk vissza, nem pedig másodszor is fordítunk és küldünk.
• —A lefordított, sorban álló vagy ütemezett üzenet szövege be van fagyasztva. Az emails.reschedule továbbra is mozgatja; ha azon akarsz változtatni, amit mond, vond vissza, és küldd el újra.

A content a hálózaton base64. Add át a bájtokat, és helyetted kódoljuk.

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