Migrer depuis Amazon SES
Quittez Amazon SES
pour OpenEmail.
Appels SESv2, jeux de configuration et événements SNS, transposés champ par champ, avec un convertisseur qui réécrit votre code.
Le même e-mail,
écrit des deux façons.
Un message avec une adresse de réponse et un tag, envoyé via Amazon SES puis via OpenEmail.
import { SESv2Client, SendEmailCommand } from '@aws-sdk/client-sesv2'const ses = new SESv2Client({ region: 'us-east-1' })const result = await ses.send(new SendEmailCommand({FromEmailAddress: 'Acme <[email protected]>',Destination: { ToAddresses: ['[email protected]'] },ReplyToAddresses: ['[email protected]'],Content: {Simple: {Subject: { Data: 'Your invoice is ready' },Body: { Html: { Data: '<p>Thanks for your order.</p>' } },},},EmailTags: [{ Name: 'category', Value: 'invoice' }],}),)console.log(result.MessageId)
import { init, openemail } from '@openemail/sdk'init({ apiKey: process.env.OPENEMAIL_API_KEY })const email = await openemail.emails.send({from: 'Acme <[email protected]>',to: ['[email protected]'],replyTo: '[email protected]',subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>',tags: { category: 'invoice' },})console.log(email.id)
Champ par champ,
ce qui va où.
Chaque option acceptée par Amazon SES, et sa place dans OpenEmail.
| Amazon SES | OpenEmail | Notes |
|---|---|---|
FromEmailAddress | from | Accepte aussi le nom et l’adresse ensemble. |
Destination.ToAddresses | to | CcAddresses et BccAddresses deviennent cc et bcc. |
ReplyToAddresses | replyTo | Une adresse par message. |
Content.Simple.Subject.Data | subject | Une simple chaîne. |
Content.Simple.Body.Html.Data | html | Le corps en texte brut va dans text. |
EmailTags: [{ Name, Value }] | tags: { Name: Value } | Jusqu’à 10 paires clé-valeur. |
Content.Template.TemplateData | template: { id, props } | Les props sont un objet, pas une chaîne JSON. |
SendBulkEmail | emails.sendBatch | Jusqu’à 100 e-mails, chacun envoyé séparément. |
ConfigurationSetName | webhooks.create | Les événements arrivent par webhooks. |
AWS credentials, region | OPENEMAIL_API_KEY | Une seule clé, et pas de région. |
Convertisseur
Collez votre code Amazon SES,
récupérez-le sur OpenEmail.
Choisissez la provenance du code et son langage. Les clés reconnues sont retirées dans votre navigateur, et rien de ce que vous collez n’est conservé.
Au-delà du code,
quatre étapes de plus.
- 01
Ajoutez votre domaine d’envoi
Ajoutez-le dans OpenEmail et publiez les enregistrements DNS indiqués. L’envoi démarre dès que l’enregistrement de signature répond.
- 02
Créez une clé API
Les clés commencent par oe_live_ et ne portent que les droits que vous leur donnez.
- 03
Déplacez vos webhooks
Créez un endpoint pour les événements listés ci-dessous et vérifiez l’en-tête X-OpenEmail-Signature de chaque requête.
- 04
Apportez contacts et suppressions
Importez vos contacts en CSV sur la page d’une audience, puis ajoutez les adresses bloquées par Amazon SES à la liste de suppression.
Les événements webhook,
renommés.
Chaque événement Amazon SES et l’événement OpenEmail qui le remplace. Chaque requête porte un seul événement, signé.
| Amazon SES | OpenEmail |
|---|---|
Send | email.sent |
Delivery | email.delivered |
DeliveryDelay | email.delivery_delayed |
Bounce | email.bounced |
Complaint | email.complained |
Open | email.opened |
Click | email.clicked |
Reject | email.failed |
Quitter Amazon SES,
les réponses à vos questions.
Vous venez
d’ailleurs ?
Chaque guide a le même convertisseur, la même table des champs et la même liste à cocher.
Converti ?
Créez la clé qu’il lit.
Un espace de travail se crée en une minute. Ajoutez votre domaine, créez une clé API et définissez OPENEMAIL_API_KEY.