Recevoir des déclencheurs webhook

Un webhook permet à un outil externe (Make, Zapier, votre site client, un formulaire...) de déclencher automatiquement une tâche sur un agent Agenia. Chaque webhook génère une URL unique que vous collez dans votre outil.

Créer un webhook

1. Dans la barre latérale, cliquez sur Webhooks
2. Cliquez sur Nouveau webhook
3. Donnez-lui un nom descriptif (ex : Nouveau lead formulaire contact)
4. Sélectionnez l'agent qui doit traiter les requêtes entrantes
5. Cliquez sur Créer

Agenia génère une URL de webhook unique, par exemple :

https://api.agenia.io/api/v1/webhooks/wh_abc123def456/trigger

Copiez cette URL — vous en aurez besoin dans votre outil externe.

Format de la requête

Votre outil doit envoyer une requête HTTP POST à l'URL du webhook. Le corps de la requête (body) contient le message transmis à l'agent.

Exemple avec curl :

curl -X POST https://api.agenia.io/api/v1/webhooks/wh_abc123def456/trigger \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Nouveau lead : Marie Dupont, directrice marketing, budget 5k€/mois"
  }'

L'agent reçoit la valeur du champ message comme instruction et crée une tâche automatiquement.

Tester votre webhook

Après avoir créé le webhook, cliquez sur Tester dans la fiche du webhook. Agenia envoie une requête de test et vous montre la réponse de l'agent. Vérifiez que la tâche apparaît bien dans la vue Tâches.

Connecter depuis Make ou Zapier

Make (ex-Integromat)

1. Ajoutez un module HTTP > Make a request
2. Collez l'URL du webhook dans le champ URL
3. Méthode : POST
4. Body type : Raw → JSON
5. Corps :

{
  "message": "{{1.data.message}}"
}

Adaptez {{1.data.message}} à la variable de votre scénario Make.

Zapier

1. Choisissez l'action Webhooks by Zapier > POST
2. Collez l'URL du webhook dans URL
3. Data : ajoutez la clé message avec la valeur souhaitée

Surveiller les déclenchements

Dans la fiche de votre webhook, l'onglet Historique liste les dernières requêtes reçues : date, statut (succès / erreur), contenu du message et ID de la tâche créée.

Prochaine étape

→ Comprendre les niveaux de sécurité