Gửi một email

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 và bcc nhận một hoặc nhiều người nhận, và một người nhận đơn lẻ sẽ được tự động bọc thành mảng. Mỗi người nhận có thể là địa chỉ trần, Name <addr@host>, hoặc { email, name }.

translate viết thông điệp bằng ngôn ngữ của người khác trước khi nó được gửi đi. Phần thân, và cả tiêu đề trừ khi bạn tắt điều đó, được dịch ngay khi API chấp nhận yêu cầu, và thứ được tạo ra chính là thứ được gửi đi: một bản dịch không thể tạo ra sẽ khiến lần gửi bị từ chối chứ không đăng nó bằng ngôn ngữ bạn đã viết.

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 }

Không ai đọc nội dung đó trước khi nó được gửi đi. emails.translate là cùng một vòng đi-về nhưng dừng sớm hơn một bước. Hãy đưa nó cho một người xem, để họ sửa, rồi gửi đúng thứ họ đã duyệt mà trong lời gọi hoàn toàn không có translate. Truyền nó lần nữa sẽ dịch lần thứ hai và vứt bỏ mọi chỉnh sửa của họ.

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

Bảng này được đóng gói sẵn, theo đúng thứ tự của bộ chọn, nên một bộ chọn có thể được điền trước cả yêu cầu đầu tiên. languages.list() trả về chính những hàng đó lấy từ đường truyền dưới dạng một mảng thuần, dành cho người gọi muốn danh sách hiện tại thay vì danh sách đi kèm phiên bản này. resolveLanguage nhận một mã, một tên tiếng Anh, một tên bản địa hoặc một bí danh (zh-TW là bí danh của một mã không còn được liệt kê), languageByCode khớp chính xác một mã và không phân biệt hoa thường, và mười sáu hàng trong đó viết từ phải sang trái. Hãy tìm kiếm đồng thời trên native, label và code, hiển thị native trước, và lưu lại mã.

• —Một ngôn ngữ không phân giải được là một validation_error trên translate.to, trước khi bất cứ thứ gì được gửi đi.
• —translation_too_long khi vượt quá 30.000 ký tự, translation_not_configured khi bản cài đặt chưa cấu hình AI, translation_failed khi nhà cung cấp không trả lời. Không trường hợp nào trong số đó gửi thông điệp chưa dịch như một phương án dự phòng.
• —Hoạt động cùng template: thứ được dịch là kết quả ĐÃ KẾT XUẤT, nên một phần thân đã lưu phục vụ được mọi ngôn ngữ mà khách hàng của bạn đọc. Một template kết xuất ra cả một tài liệu vẫn giữ nguyên doctype, các khối <style> và các quy tắc @font-face của nó: chỉ phần thân được đưa tới mô hình và phần còn lại được đặt lại xung quanh nó. <title> của nó được giữ nguyên, mà dù sao cũng chẳng có gì hiển thị nó.
• —Một lần thử lại không tốn thêm gì. Bản dịch không nằm trong dấu vân tay idempotency (yêu cầu thì có, kể cả translate), nên thử lại một lần gửi chưa được trả lời với cùng Idempotency-Key sẽ phát lại thông điệp đã tồn tại thay vì dịch và gửi một thông điệp thứ hai.
• —Một thông điệp đã dịch đang nằm trong hàng đợi hoặc đã hẹn giờ thì bị đóng băng về mặt câu chữ. emails.reschedule vẫn dời được nó; muốn đổi nội dung thì phải huỷ và gửi lại.

content là base64 trên đường truyền. Hãy truyền vào các byte và chúng sẽ được mã hoá giúp bạn.

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