Dërgimi i një email-i

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 dhe bcc pranojnë një marrës ose shumë, dhe një i vetëm mbështillet për ju. Secili mund të jetë një adresë e thjeshtë, Name <addr@host>, ose { email, name }.

translate e shkruan mesazhin në gjuhën e dikujt tjetër para se ai të niset. Trupi, dhe subjekti veç nëse e fikni, përkthehet kur API-ja e pranon kërkesën, dhe ajo që doli është ajo që niset: një përkthim që nuk mund të prodhohej e refuzon dërgimin në vend që ta nisë mesazhin në gjuhën në të cilën e shkruat.

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 }

Askush nuk e lexoi atë para se të nisej. emails.translate është i njëjti udhëtim, i ndalur një hap më herët. Tregojani një personi, lëreni ta ndryshojë, pastaj dërgoni atë që ai miratoi pa asnjë translate te thirrja. Dhënia e tij sërish do ta përkthente për herë të dytë dhe do t'i hidhte poshtë ndryshimet e tij.

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

Tabela vjen e bashkëngjitur në paketë, në rendin e zgjedhësit, kështu që një zgjedhës mund të mbushet para kërkesës së parë. languages.list() jep të njëjtët rreshta nga rrjeti si një array i thjeshtë, për një thirrës që i preferon ato aktualet nga ato me të cilat u dërgua ky version. resolveLanguage pranon një kod, një emër në anglisht, një endonim ose një alias (zh-TW është alias i një kodi që nuk listohet më), languageByCode përputh një kod të saktë pa dallim shkronjash të mëdha e të vogla, dhe gjashtëmbëdhjetë nga rreshtat janë nga e djathta në të majtë. Kërkoni native, label dhe code bashkë, shfaqni native të parin, dhe ruani kodin.

• —Një gjuhë që nuk zgjidhet në asgjë është një validation_error mbi translate.to, para se të dërgohet asgjë.
• —translation_too_long mbi 30.000 karaktere, translation_not_configured kur instalimi nuk ka AI të konfiguruar, translation_failed kur ofruesi nuk u përgjigj. Asnjëri prej tyre nuk e dërgon mesazhin të papërkthyer si zgjidhje rezervë.
• —Funksionon me template: ajo që përkthehet është dalja e RENDERUAR, kështu që një trup i vetëm i ruajtur u shërben të gjitha gjuhëve në të cilat lexojnë klientët tuaj. Një template që renderon një dokument të tërë e ruan doctype-in e vet, blloqet e veta <style> dhe rregullat @font-face: te modeli shkon vetëm trupi dhe pjesa tjetër vendoset sërish rreth tij. <title> i tij lihet i paprekur, gjë që nuk e shfaq gjithsesi asgjë.
• —Një riprovim nuk kushton asgjë më shumë. Përkthimi nuk është pjesë e gjurmës së idempotencës (kërkesa është, përfshirë translate), kështu që riprovimi i një dërgimi pa përgjigje me të njëjtin Idempotency-Key riluan mesazhin që ekziston tashmë në vend që të përkthejë e të dërgojë një të dytë.
• —Një mesazh i përkthyer që është në radhë ose i planifikuar është i ngrirë ndaj ndryshimeve të formulimit. emails.reschedule e zhvendos gjithsesi; ndryshimi i asaj që thotë do të thotë ta anuloni dhe ta dërgoni sërish.

content është base64 në rrjet. Jepni bajte dhe ato kodohen për ju.

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