Documentation — démarrage
Guide pratique pour recevoir un premier webhook, configurer une action et lire les journaux. Remplacez
toujours VOTRE_JETON par le jeton fourni dans l’application.
Qu’est-ce qu’un webhook ?
Un webhook est une URL appelée par une application ou un formulaire lorsqu’un événement survient. Webhooky reçoit cet appel, journalise le payload, puis exécute les actions configurées.
Créer un compte
- Ouvrez la page d’inscription.
- Validez votre e-mail si demandé.
- Connectez-vous sur webhooky.builders.
Créer une organisation
L’abonnement, les connecteurs et les webhooks sont rattachés à une organisation. Complétez l’onboarding (profil, adresse de facturation si nécessaire, choix du forfait).
Créer un webhook
- Créez un projet si besoin, puis un webhook formulaire.
- Copiez l’URL d’ingress générée.
- Ajoutez une ou plusieurs actions.
- Utilisez le mode brouillon pour tester sans consommer le quota de production.
Exemple de payload JSON
{
"name": "Jean Dupont",
"email": "jean.dupont@example.com",
"subject": "Demande de démonstration",
"message": "Je souhaite découvrir Webhooky."
} Exemples d’envoi
VOTRE_JETON.
curl -X POST "https://webhooky.builders/webhook/form/VOTRE_JETON" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{ "name": "Jean Dupont", "email": "jean.dupont@example.com", "subject": "Demande de démonstration", "message": "Je souhaite découvrir Webhooky."}' await fetch('https://webhooky.builders/webhook/form/VOTRE_JETON', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Accept: 'application/json',
},
body: JSON.stringify({
name: 'Jean Dupont',
email: 'jean.dupont@example.com',
subject: 'Demande de démonstration',
message: 'Je souhaite découvrir Webhooky.',
}),
}); use Symfony\Component\HttpClient\HttpClient;
$client = HttpClient::create();
$response = $client->request('POST', 'https://webhooky.builders/webhook/form/VOTRE_JETON', [
'headers' => [
'Accept' => 'application/json',
],
'json' => [
'name' => 'Jean Dupont',
'email' => 'jean.dupont@example.com',
'subject' => 'Demande de démonstration',
'message' => 'Je souhaite découvrir Webhooky.',
],
]);
$status = $response->getStatusCode(); <form action="https://webhooky.builders/webhook/form/VOTRE_JETON" method="post">
<label>Nom <input name="name" required></label>
<label>E-mail <input type="email" name="email" required></label>
<label>Message <textarea name="message" required></textarea></label>
<button type="submit">Envoyer</button>
</form>
<!-- Préférez un envoi JSON via JavaScript si votre formulaire est moderne.
Ne placez jamais de secret dans le HTML. --> Configurer une action Mailjet
Ajoutez une connexion Mailjet dans l’organisation, puis une action template sur le webhook. Guide détaillé : intégration Mailjet.
Envoyer un test et lire les journaux
- Utilisez la fonction de test de l’interface ou un appel curl.
- Ouvrez l’historique d’exécution.
- Vérifiez le statut de chaque action.
Gestion des erreurs
- 402 — quota d’événements atteint ou abonnement inactif.
- Erreur d’action — connecteur mal configuré, modèle introuvable, destinataire invalide…
- Corrigez la configuration puis renvoyez un test.
Bonnes pratiques de sécurité
- Gardez les jetons d’URL confidentiels.
- Ne stockez pas de clés fournisseurs dans vos sites.
- Minimisez les données personnelles envoyées dans le payload.
- Surveillez les journaux et la consommation de quota.
- Préférez HTTPS pour toutes les destinations HTTP sortantes.
Passez à la pratique
Créez un compte gratuit, générez une URL et connectez votre première action.