Sweego est intégré aux composants Mailer et Notifier de Symfony 7.2

Envoyez vos emails et sms facilement avec votre framework php préféré, Symfony !

Découvrez l’intégration de Sweego à Symfony 7.2 pour vos emails et SMS

Nous sommes heureux d’annoncer que Sweego, votre solution SAAS d’envoi d’emails et de SMS, est désormais pleinement intégrée aux composants Mailer et Notifier de Symfony. Avec la sortie de Symfony 7.2, cette intégration offre une manière simple et efficace de connecter vos envois directement à vos applications Symfony.

Qu’est-ce que Symfony ?

Au cas où certains d’entre vous ne connaîtrez pas encore Symfony, il s’agit de l’un des frameworks PHP les plus populaires et puissants, utilisé par des milliers de développeurs et entreprises à travers le monde (+ de 600 000 développeurs) pour créer des applications web robustes, évolutives et performantes. Avec une architecture modulaire et une vaste communauté, Symfony facilite le développement grâce à ses nombreux composants réutilisables et ses standards élevés.

Pourquoi choisir Sweego avec Symfony ?

• Une souveraineté européenne : Vos données restent en Europe et respectent le RGPD.
• Une API robuste et simple à utiliser : Compatible avec Mailer pour les emails et Notifier pour les SMS.
• Flexibilité : Personnalisez vos intégrations grâce à un support complet des webhooks.
• Expert en délivrabilité : les collaborateurs de Sweego cumulent plusieurs dizaines d’années d’expérience dans l’envoi d’emails de masse avec plusieurs milliards envoyés par an.

Mise en place rapide avec Symfony 7.2

Prérequis

Avant de commencer, assurez-vous d’avoir :

1. Une clé d’API Sweego. Vous pouvez la générer depuis votre espace client Sweego. (Voir la documentation)
2. Un domaine validé sur la plateforme Sweego pour l’envoi d’emails.

Installation des packages

Ajoutez les packages nécessaires à votre projet Symfony :

composer require symfony/sweego-mailer symfony/sweego-notifier

Configurer Mailer pour envoyer des emails avec Sweego

Ajoutez votre configuration Sweego dans le fichier .env de votre projet :

Envoi par SMTP :

# SMTP
MAILER_DSN=sweego+smtp://LOGIN:PASSWORD@HOST:PORT

Envoi via API :

# API
MAILER_DSN=sweego+api://API_KEY@default

Dans votre application, envoyer un email devient simple :

use Symfony\Component\Mailer\Transport\TransportInterface;
use Symfony\Component\Mailer\Mailer;
use Symfony\Component\Mime\Email;

public function sendEmail(TransportInterface $transport): void
{
    $mailer = new Mailer($transport);

    $email = (new Email())
        ->from('example@yourdomain.com')
        ->to('recipient@example.com')
        ->subject('Hello from Sweego!')
        ->text('This is a test email sent using Symfony Mailer and Sweego.');

    $mailer->send($email);
}

Configurer Notifier pour envoyer des SMS avec Sweego

Ajoutez la configuration suivante pour Sweego dans le fichier services.yaml :

framework:
    notifier:
        texter_transports:
            sweego: '%env(SWEEGO_SMS_DSN)%'

Ajoutez votre clé d’API Sweego dans le fichier .env :

SWEEGO_SMS_DSN=sweego://API_KEY@default?region=REGION&campaign_type=CAMPAIGN_TYPE&bat=BAT&campaign_id=CAMPAIGN_ID&shorten_urls=SHORTEN_URLS&shorten_with_protocol=SHORTEN_WITH_PROTOCOL

Où :

• API_KEY (requis) est votre clef d’API Sweego
• REGION (requis) est la région du numéro de téléphone (ex. FR, ISO 3166-1 alpha-2 country code)
• CAMPAIGN_TYPE (requis) est le type de campagne (ex. transac)
• BAT (optionnel) permet d’envoyer un sms de test à votre numéro de test sms (ex. true)
• CAMPAIGN_ID (optionnel) est l’ID de campagne (ex. string)
• SHORTEN_URLS (optionnel) si l’option de raccourcisseur d’url est activé (ex. true)
• SHORTEN_WITH_PROTOCOL (optionnel) est l’option de raccourcissement avec protocole (ex. true)

Envoyez un SMS directement depuis votre application :

use Symfony\Component\Notifier\Message\SmsMessage;
use Symfony\Component\Notifier\TexterInterface;

public function sendSms(TexterInterface $texter): void
{
    $sms = new SmsMessage(
        '+123456789', // Numéro du destinataire
        'Hello! This SMS was sent using Symfony Notifier and Sweego.'
    );

    $texter->send($sms);
}

Suivi en temps réel avec les webhooks

Avec l’intégration des webhooks, vous pouvez recevoir des notifications en temps réel sur les événements de vos envois. Par exemple, un email délivré, un SMS échoué, etc. Consultez notre documentation pour configurer vos webhooks dans Sweego.

Repositories GitHub

Retrouvez les composants Sweego sur Symfony sur GitHub :

• Sweego Mailer : Documentation et code pour l’envoi d’emails.
• Sweego Notifier : Documentation et code pour l’envoi de SMS.

Avec cette nouvelle intégration, nous simplifions l’utilisation de Sweego dans vos projets Symfony. Si vous avez des questions ou souhaitez explorer davantage de fonctionnalités, n’hésitez pas à nous les poser sur Slack ou Discord ou demander une nouvelle fonctionnalité sur notre outil de feedback

L’équipe de Sweego est heureuse d’avoir sponsorisé le développement de ces composants grâce à l’excellent travail de Welcomattic

Envoyez rapidement votre premier message !

Envoyez jusqu’à 500 emails par jour avec un compte gratuit

Démarrez