Enviar um 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 e bcc aceitam um ou vários destinatários, e um único é envolvido num array automaticamente. Cada um pode ser um endereço simples, Name <addr@host> ou { email, name }.

translate escreve a mensagem na língua de outra pessoa antes de ela partir. O corpo, e o assunto a menos que o desative, é traduzido quando a API aceita o pedido, e o que saiu é o que vai sair: uma tradução que não pôde ser produzida recusa o envio em vez de o publicar na língua em que o escreveu.

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 }

Ninguém leu aquilo antes de partir. emails.translate é a mesma ida e volta parada um passo antes. Mostre-a a uma pessoa, deixe-a alterá-la e depois envie o que ela aprovou sem qualquer translate na chamada. Passá-lo outra vez traduziria uma segunda vez e deitaria fora as edições dela.

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 tabela vem incluída, pela ordem do seletor, para que um seletor possa ser preenchido antes do primeiro pedido. languages.list() resolve para as mesmas linhas vindas da rede sob a forma de um array simples, para quem prefira as atuais às que esta versão trouxe. resolveLanguage aceita um código, um nome em inglês, um endónimo ou um alias (zh-TW é um alias de um código que já não é listado), languageByCode faz corresponder um código exato sem distinguir maiúsculas de minúsculas, e dezasseis das linhas são da direita para a esquerda. Pesquise native, label e code em conjunto, mostre native primeiro e guarde o código.

• —Um idioma que não resolve para nada é um validation_error em translate.to, antes de seja o que for ser enviado.
• —translation_too_long acima de 30 000 caracteres, translation_not_configured quando a instalação não tem IA configurada, translation_failed quando o fornecedor não respondeu. Nenhum deles envia a mensagem por traduzir como alternativa.
• —Funciona com template: é o resultado RENDERIZADO que é traduzido, por isso um corpo guardado serve todas as línguas em que os seus clientes leem. Um template que renderiza um documento inteiro mantém o seu doctype, os seus blocos <style> e as suas regras @font-face: só o corpo vai para o modelo e o resto é reposto à volta dele. O seu <title> fica intacto, e nada o mostra de qualquer forma.
• —Uma repetição não custa nada a mais. A tradução não faz parte da impressão digital de idempotência (o pedido faz, translate incluído), por isso repetir um envio sem resposta com a mesma Idempotency-Key reproduz a mensagem que já existe em vez de traduzir e enviar uma segunda.
• —Uma mensagem traduzida que esteja em fila ou agendada fica congelada contra alterações de texto. emails.reschedule continua a movê-la; mudar o que diz significa cancelar e enviar de novo.

content vai em base64 na rede. Passe bytes e são codificados por si.

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