Symfony + Webhooky : sortez vos intégrations de votre code
Plutôt que d’installer et maintenir un SDK par fournisseur (e-mail, SMS, messagerie), votre application Symfony envoie un événement JSON à Webhooky, qui exécute les actions configurées.
Changer de prestataire devient une modification de configuration, pas un déploiement.
Comment ça marche
- Symfony envoie un POST (JSON ou formulaire) vers l’URL de votre webhook Webhooky.
- Webhooky exécute les actions configurées : e-mail, SMS, messagerie, HTTP…
- Chaque exécution est visible dans les journaux.
Configurer Symfony pas à pas
1. Stocker l’URL en variable d’environnement
Ajoutez WEBHOOKY_URL dans .env.local (jamais dans le dépôt).
2. Envoyer l’événement
Utilisez Symfony HttpClient (exemple ci-dessous). Pour ne pas ralentir la requête utilisateur, faites l’appel dans un handler Messenger asynchrone.
3. Configurer les actions
Dans Webhooky : Mailjet, SMS, Slack, HTTP… selon vos besoins.
4. Superviser
Les journaux d’exécution centralisent les succès et échecs de chaque action.
use Symfony\Contracts\HttpClient\HttpClientInterface;
final class WebhookyNotifier
{
public function __construct(
private HttpClientInterface $client,
private string $webhookyUrl, // %env(WEBHOOKY_URL)%
) {}
public function notify(array $payload): void
{
$this->client->request('POST', $this->webhookyUrl, [
'headers' => ['Accept' => 'application/json'],
'json' => $payload,
'timeout' => 10,
])->getStatusCode(); // déclenche l’envoi et lève une exception en cas d’erreur réseau
}
} Exemple de payload reçu
{
"name": "Jean Dupont",
"email": "jean.dupont@example.com",
"message": "Bonjour, je souhaite un devis."
} Cas d’usage
- E-mails transactionnels sans SDK Mailjet
- Alertes Slack/Teams sur événements métier
- Fan-out d’un événement vers plusieurs API
Combien ça coûte ?
Chaque action exécutée compte pour un événement. Le forfait Free inclut 100 événements sans carte bancaire ; Starter (9 € HT/mois) en inclut 5 000. Détails sur la page Tarifs.
Questions fréquentes
Dois-je utiliser Messenger ?
Ce n’est pas obligatoire, mais recommandé en production : l’appel HTTP se fait en arrière-plan et peut être retenté par Messenger en cas d’erreur réseau.
Comment gérer un quota atteint ?
Webhooky répond HTTP 402 quand le quota d’événements est atteint. Journalisez ce cas côté application pour être alerté.
À lire aussi
- Guide complet : webhook Symfony
- Action HTTP
- Webhooky pour les développeurs
- Toutes les intégrations
- Tarifs Webhooky
Connectez Symfony en quelques minutes
Créez un compte gratuit, générez une URL et connectez votre première action.
Forfait Free · sans carte bancaire · 100 événements inclus