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

  1. Symfony envoie un POST (JSON ou formulaire) vers l’URL de votre webhook Webhooky.
  2. Webhooky exécute les actions configurées : e-mail, SMS, messagerie, HTTP…
  3. 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.

PHP — Symfony HttpClient
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

JSON (fictif)
{
  "name": "Jean Dupont",
  "email": "jean.dupont@example.com",
  "message": "Bonjour, je souhaite un devis."
}

Cas d’usage

Sécurité : Ne placez jamais de jeton, d’URL secrète ou de clé API dans le code front de vos sites. Les identifiants des connecteurs restent côté serveur, dans votre organisation Webhooky.

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

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

Cette page vous a-t-elle été utile ?