Envoyer un e-mail

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 et bcc acceptent un destinataire ou plusieurs, et un destinataire seul est enveloppé pour vous. Chacun peut être une adresse nue, Name <addr@host>, ou { email, name }.

translate rédige le message dans la langue de quelqu'un d'autre avant son départ. Le corps, et l'objet sauf si vous le désactivez, est traduit au moment où l'API accepte la requête, et ce qui en est sorti est ce qui part : une traduction qui n'a pas pu être produite fait refuser l'envoi plutôt que d'expédier le message dans la langue où vous l'avez écrit.

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 }

Personne n'a relu ce texte avant son départ. emails.translate est le même aller-retour, arrêté une étape plus tôt. Montrez-le à une personne, laissez-la le modifier, puis envoyez ce qu'elle a approuvé sans aucun translate sur l'appel. Le repasser traduirait une deuxième fois et jetterait ses corrections.

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

La table est embarquée dans le package, dans l'ordre du sélecteur, pour qu'un sélecteur puisse être rempli avant la première requête. languages.list() renvoie les mêmes lignes depuis le réseau sous forme d'array simple, pour un appelant qui préfère les lignes actuelles à celles livrées avec cette version. resolveLanguage accepte un code, un nom anglais, un endonyme ou un alias (zh-TW est l'alias d'un code qui n'est plus listé), languageByCode fait correspondre un code exact sans tenir compte de la casse, et seize des lignes s'écrivent de droite à gauche. Cherchez dans native, label et code à la fois, affichez native en premier, et stockez le code.

• —Une langue qui ne se résout à rien donne un validation_error sur translate.to, avant que quoi que ce soit ne soit envoyé.
• —translation_too_long au-delà de 30 000 caractères, translation_not_configured quand l'installation n'a aucune IA configurée, translation_failed quand le fournisseur n'a pas répondu. Aucun d'eux n'envoie le message non traduit en guise de repli.
• —Fonctionne avec template : c'est la sortie RENDUE qui est traduite, si bien qu'un seul corps stocké sert toutes les langues que lisent vos clients. Un template qui rend un document entier conserve son doctype, ses blocs <style> et ses règles @font-face : seul le corps part vers le modèle et le reste est remis autour. Son <title> est laissé tel quel, et rien ne l'affiche de toute façon.
• —Une retentative ne coûte rien de plus. La traduction ne fait pas partie de l'empreinte d'idempotence (la requête, elle, en fait partie, translate compris) : réessayer un envoi resté sans réponse avec la même Idempotency-Key rejoue donc le message qui existe déjà au lieu d'en traduire et d'en envoyer un second.
• —Un message traduit en file ou planifié est figé quant à sa formulation. emails.reschedule le déplace toujours ; changer ce qu'il dit suppose de l'annuler et de l'envoyer à nouveau.

content circule en base64. Transmettez des octets et ils sont encodés pour vous.

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