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

  1. Ouvrez la page d’inscription.
  2. Validez votre e-mail si demandé.
  3. 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

  1. Créez un projet si besoin, puis un webhook formulaire.
  2. Copiez l’URL d’ingress générée.
  3. Ajoutez une ou plusieurs actions.
  4. Utilisez le mode brouillon pour tester sans consommer le quota de production.

Exemple de payload JSON

JSON
{
  "name": "Jean Dupont",
  "email": "jean.dupont@example.com",
  "subject": "Demande de démonstration",
  "message": "Je souhaite découvrir Webhooky."
}

Exemples d’envoi

Sécurité : Ne publiez jamais un jeton réel. Les exemples utilisent le placeholder VOTRE_JETON.
curl
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."}'
JavaScript (fetch)
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.',
  }),
});
PHP (Symfony HttpClient)
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();
Formulaire HTML
<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

  1. Utilisez la fonction de test de l’interface ou un appel curl.
  2. Ouvrez l’historique d’exécution.
  3. Vérifiez le statut de chaque action.

Gestion des erreurs

Bonnes pratiques de sécurité

Passez à la pratique

Créez un compte gratuit, générez une URL et connectez votre première action.