Nouveaux SDK pour .NET, Rust, Elixir et Symfony

Votre stack repose sur .NET, Rust, Elixir ou Symfony ? Vous pouvez désormais connecter Lettermint à votre application avec un SDK officiel. Une fois installé, vous envoyez des e-mails transactionnels et des e-mails broadcast en quelques lignes de code.

Vous connaissez peut-être déjà les packages community pour .NET, Elixir et Symfony. Ils restent utilisables. Les SDK officiels, eux, sont maintenus par notre équipe. Chaque nouvelle fonctionnalité de Lettermint y est donc ajoutée.

Envoyer des e-mails avec .NET et C#

Le SDK .NET est disponible sur NuGet et nécessite .NET 8 ou supérieur. Veillez à installer Lettermint. Le SDK community de ExciteOrg (ouvre dans une nouvelle fenêtre) s'appelle LettermintDotNet.

Voici comment envoyer votre premier e-mail :

          using Lettermint;

using var email = LettermintClient.Email("lm_project_token");

var response = await email
    .From("sender@acme.com")
    .To("recipient@acme.com")
    .Subject("Hello from Lettermint")
    .Html("<p>Hello World!</p>")
    .SendAsync();

        

Le guide .NET explique comment ajouter des pièces jointes et utiliser la Team API.

Le SDK Rust devient officiel

Franz Geffke (ouvre dans une nouvelle fenêtre) a développé la première version du SDK Rust. Nous en avons repris la maintenance et publié la version 1.0, qui fonctionne désormais comme nos autres SDK. Sur crates.io, le paquet s'appelle toujours lettermint. Il vous faut Rust 1.98 ou supérieur, ainsi qu'un runtime asynchrone comme Tokio.

Avec la version 1.0, un envoi ressemble à ceci :

          use lettermint::Lettermint;

#[tokio::main]
async fn main() -> lettermint::Result<()> {
    let email = Lettermint::email("lm_project_token")?;

    email
        .email()
        .from("sender@acme.com")
        .to("recipient@acme.com")
        .subject("Hello from Lettermint")
        .html("<p>Hello World!</p>")
        .send()
        .await?;

    Ok(())
}

        

Vous utilisez déjà le SDK Rust ? Tant que votre Cargo.toml indique lettermint = "0.3", rien ne change pour vous. Avant de passer à la 1.0, lisez le guide de migration (ouvre dans une nouvelle fenêtre). Toutes les options se trouvent dans le guide Rust.

Des e-mails transactionnels depuis Elixir et Phoenix

Le SDK Elixir est disponible sur Hex, à partir d'Elixir 1.15. Il fonctionne dans n'importe quel projet Mix, y compris votre application Phoenix. Vous construisez un e-mail étape par étape :

          alias Lettermint.EmailBuilder, as: Email

client = Lettermint.email("lm_project_token")

client
|> Email.new()
|> Email.from("sender@acme.com")
|> Email.to(["recipient@acme.com"])
|> Email.subject("Hello from Lettermint")
|> Email.html("<p>Hello World!</p>")
|> Email.send()

        

Vous envoyez vos e-mails avec Swoosh ? Gardez alors l'adaptateur Lettermint (ouvre dans une nouvelle fenêtre) pour l'envoi. Le SDK ne le remplace pas. Il devient utile si vous voulez aussi appeler la Team API ou vérifier vos webhooks. Vous trouverez d'autres exemples dans le guide Elixir.

Connecter Lettermint à Symfony Mailer

Pour Symfony Mailer, installez lettermint/symfony-mailer avec Composer. Il vous faut PHP 8.2 et Symfony Mailer 6.4, 7.4 ou 8. Une intégration community de somehow digital (ouvre dans une nouvelle fenêtre) existait déjà. Vous pouvez continuer à l'utiliser.

Après l'installation, enregistrez l'intégration une seule fois dans config/services.yaml. Ajoutez ensuite votre project API token au DSN :

      MAILER_DSN=lettermint+api://lm_project_token@default

    

C'est tout. Vous continuez à envoyer vos e-mails avec MailerInterface, sans toucher à votre code. Les e-mails que vous mettez en file d'attente avec Symfony Messenger passent eux aussi par Lettermint. Le guide Symfony détaille l'étape d'enregistrement.

Tous nos SDK officiels

Les SDK .NET, Rust et Elixir ne servent pas qu'à envoyer des e-mails. Ils vous permettent aussi de gérer vos domaines et vos projets via la Team API et de vérifier la signature des webhooks.

Nous proposons désormais des SDK et des intégrations officiels pour Node.js, Nuxt, PHP, Laravel, Symfony, Python, Go, Java, .NET, Elixir et Rust. Tous les e-mails que vous envoyez avec eux sont traités dans l'UE. Vous les retrouverez sur notre page des intégrations.